복제본 세트에 대한 롤링 인덱스 빌드
인덱스 빌드는 복제본 세트 성능에 영향을 미칠 수 있습니다. 기본적으로 MongoDB는 모든 데이터가 포함된 복제본 세트 멤버에서 동시에 인덱스를 빌드합니다. 인덱스 빌드로 인한 성능 저하를 허용할 수 없는 워크로드는 다음 절차를 사용하여 인덱스를 롤링 방식으로 빌드하는 것이 좋습니다.
롤링 인덱스 빌드는 한 번에 하나의 복제본 세트 노드만 중단시키며, 보조 노드부터 시작하여 해당 노드에서 독립적으로 인덱스를 빌드합니다. 롤링 인덱스 빌드에는 하나 이상의 복제본 선정이 필요합니다.
참고
Atlas Atlas 의 인덱스 관리 페이지를 참조하세요.
고려 사항
Unique Indexes
다음 절차를 사용하여 고유 인덱스를 만들려면 이 절차 중에 컬렉션에 대한 모든 쓰기를 중지해야 합니다.
이 절차가 진행되는 동안 컬렉션의 모든 쓰기 작업을 중단할 수 없는 경우, 해당 페이지에 이 절차를 수행하지 않습니다. 대신 복제본 세트의 프라이머리에 db.collection.createIndex()를 발행하여 컬렉션에 고유한 인덱스를 빌드합니다.
Oplog 크기
너무 뒤쳐져 뒤쳐지지 않으면서 인덱싱 또는 재인덱싱 작업을 완료할 수 있을 만큼 Oplog가 충분히 커야 합니다. 자세한 내용은 Oplog 크기 조정 문서를 참조하세요.
전제 조건
- 고유 인덱스 구축용
다음 절차를 사용하여 고유 인덱스를 만들려면 인덱스 빌드 중에 컬렉션에 대한 모든 쓰기를 중지해야 합니다. 그렇지 않으면 복제본 세트 구성원 간에 데이터가 일관되지 않을 수 있습니다.
경고
컬렉션에 대한 모든 쓰기를 중지할 수 없는 경우 다음 절차를 사용하여 고유 인덱스를 생성하지 마십시오.
절차
중요
순차적으로 인덱스를 빌드하는 다음 절차는 복제본 세트 배포서버에 적용되며 샤딩된 클러스터에는 적용되지 않습니다. 샤딩된 클러스터의 절차에 대해서는 샤딩된 클러스터의 롤링 인덱스 빌드를 참조하세요.
1. 하나의 세컨더리를 숨기고 다시 시작합니다.
프라이머리 노드에서 다음 명령을 실행하여 새 인덱스 를 빌드 세컨더리 노드 를 숨깁니다.
이 예시 에서 새 인덱스 를 빌드 세컨더리 노드는 cfg.members 의 세 번째 노드 입니다.
var cfg = rs.conf(); // Record originalPriority so that you can reset it later. var originalPriority = cfg.members[2].priority; cfg.members[2].priority = 0; cfg.members[2].hidden = 1; rs.reconfig(cfg);
2. 하나의 세컨더리를 중지하고 독립형으로 다시 시작합니다.
세컨더리와 관련된 mongod 프로세스를 중지합니다. 다음 구성을 업데이트한 후 다시 시작합니다.
구성 파일을 사용하는 경우 다음 구성 업데이트를 수행합니다.
replication.replSetName옵션을 코멘트합니다.setParameter섹션에서 파라미터disableLogicalSessionCacheRefresh를true로 설정합니다.
예를 들어 복제본 세트 멤버의 업데이트된 설정 파일에는 다음 예와 같은 콘텐츠가 포함됩니다.
net: bindIp: localhost,<hostname(s)|ip address(es)> port: 27217 # port: 27017 #replication: # replSetName: myRepl setParameter: disableLogicalSessionCacheRefresh: true
기타 설정 (예: storage.dbPath 등)은 동일하게 유지합니다.
그리고 다시 시작합니다:
mongod --config <path/To/ConfigFile>
명령줄 옵션을 사용하는 경우 다음과 같이 구성을 업데이트합니다.
--setParameter옵션에서 매개 변수disableLogicalSessionCacheRefresh를true로 설정합니다.
예를 들어 복제본 세트 멤버가 일반적으로 기본 포트인 27017 및 --replSet 옵션에서 실행되는 경우 다른 포트를 지정하고 --replSet 옵션을 생략하고 disableLogicalSessionCacheRefresh 매개변수를 true로 설정합니다.
mongod --port 27217 --setParameter disableLogicalSessionCacheRefresh=true
기타 설정 (예: --dbpath 등)은 동일하게 유지합니다.
| [1] | (1, 2) 다른 포트에서 mongod를 실행하면 인덱스를 구축하는 동안 복제본 세트의 다른 구성원과 모든 클라이언트가 해당 구성원과 접촉하지 않도록 합니다. |
3. 인덱스를 빌드합니다.
새 포트에서 독립 실행형으로 실행 중인 mongod 인스턴스에 직접 연결하고 이 인스턴스에 대한 새 인덱스를 만듭니다.
예를 들어 mongosh(을)를 인스턴스에 연결하고, createIndex()(을)를 사용하여 records 컬렉션의 username 필드에 오름차순 인덱스를 생성합니다.
db.records.createIndex( { username: 1 } )
4. 프로그램을 복제본 세트 mongod 멤버로 다시 시작합니다.
인덱스 빌드 가 완료되면 인스턴스 를 종료합니다. 노드 를 원래 구성으로 되돌리려면 노드 를 독립형 으로 시작할 때 구성 변경 사항을 실행 취소합니다. 그런 다음 복제본 세트 의 멤버로 노드 를 다시 mongod 시작합니다.
중요
반드시 disableLogicalSessionCacheRefresh 매개 변수를 제거합니다.
예를 들어 복제본 세트 구성원을 다시 시작하려면 다음을 수행합니다.
구성 파일을 사용하는 경우:
원래 포트 번호로 되돌립니다.
replication.replSetName코멘트를 삭제합니다.setParameter섹션에서 매개변수disableLogicalSessionCacheRefresh를 제거합니다.
예를 들면 다음과 같습니다.
net: bindIp: localhost,<hostname(s)|ip address(es)> port: 27017 replication: replSetName: myRepl
기타 설정 (예: storage.dbPath 등)은 동일하게 유지합니다.
그리고 다시 시작합니다:
mongod --config <path/To/ConfigFile>
중요
다음 단계를 시작하기 전에 복제 가 이 멤버를 따라잡을 수 있도록 허용합니다.
5. 세컨더리 숨기기를 해제합니다.
프라이머리 노드에서 다음 명령을 실행하여 인덱스 를 구축한 세컨더리 노드 의 숨기기를 해제합니다. 이 예시 에서 인덱스 를 구축한 세컨더리 노드 는 cfg.members 의 세 번째 노드 입니다.
var cfg = rs.conf(); cfg.members[2].priority = originalPriority; cfg.members[2].hidden = false; rs.reconfig(cfg);
6. 나머지 세컨더리에 대해 이 절차를 반복합니다.
구성원이 세트의 다른 구성원을 따라잡으면 나머지 세컨더리 구성원에 대해 한 번에 한 구성원씩 절차를 반복합니다.
7. 프라이머리에서 인덱스를 빌드합니다.
모든 세컨더리에 새 인덱스가 있으면 프라이머리를 강등하고 위에서 설명한 절차에 따라 독립형으로 다시 시작한 다음 이전 프라이머리에 인덱스를 빌드합니다.
rs.stepDown()에서mongosh메서드를 사용하여 기본값을 내릴 수 있습니다. 단계적 하향에 성공하면 현재 프라이머리이 세컨더리가 되고 복제 세트 구성원은 새 프라이머리를 선택합니다.