문서 메뉴

문서 홈애플리케이션 개발MongoDB 매뉴얼

분할된 클러스터에서 롤링 인덱스 빌드

이 페이지의 내용

  • 고려 사항
  • 전제 조건
  • 절차
  • 추가 정보

인덱스 빌드는 shard cluster 성능에 영향을 미칠 수 있습니다. 기본적으로 MongoDB는 모든 데이터 보유 replica set 멤버에서 동시에 인덱스를 빌드합니다. shard cluster의 인덱스 빌드는 인덱싱되는 collection에 대한 데이터를 포함하는 해당 shard에서만 발생합니다. 인덱스 빌드로 인한 성능 저하를 견딜 수 없는 워크로드의 경우, 다음 절차를 사용하여 롤링 방식으로 인덱스를 빌드하는 것이 좋습니다.

롤링 인덱스 빌드는 한 번에 하나의 샤드 복제본 세트 멤버만 중단시키며, 세컨더리 멤버부터 시작하여 해당 멤버에서 독립형으로 인덱스를 빌드합니다. 롤링 인덱스 빌드에는 샤드당 하나 이상의 복제본 세트 투표가 필요합니다.

다음 절차를 사용하여 고유 인덱스를 만들려면 이 절차 중에 컬렉션에 대한 모든 쓰기를 중지해야 합니다.

이 절차가 진행되는 동안 컬렉션의 모든 쓰기 작업을 중단할 수 없는 경우, 해당 페이지에 이 절차를 수행하지 않습니다. 대신, 샤딩된 클러스터의 mongos에서 db.collection.createIndex()를 실행하여 컬렉션에 고유한 인덱스를 빌드합니다.

너무 뒤쳐져 뒤쳐지지 않으면서 인덱싱 또는 재인덱싱 작업을 완료할 수 있을 만큼 Oplog가 충분히 커야 합니다. 자세한 내용은 Oplog 크기 조정 문서를 참조하세요.

고유 인덱스 구축용
  1. 다음 절차를 사용하여 고유 인덱스를 만들려면 인덱스 빌드 중에 컬렉션에 대한 모든 쓰기를 중지해야 합니다. 그렇지 않으면 복제본 세트 멤버 간에 데이터가 일관되지 않을 수 있습니다. 컬렉션에 대한 모든 쓰기를 중지할 수 없는 경우 다음 절차를 사용하여 고유 인덱스를 생성하지 마세요.

    경고

    컬렉션에 대한 모든 쓰기를 중지할 수 없는 경우 다음 절차를 사용하여 고유 인덱스를 생성하지 마십시오.

  2. 인덱스를 생성하기 전에 컬렉션에 인덱스 제약 조건을 위반하는 문서가 없는지 확인합니다. 만약 컬렉션이 여러 샤드에 분산되어 있고 샤드에 중복 문서가 있는 청크가 포함되어 있는 경우, 중복이 없는 샤드에서는 인덱스 생성 작업이 성공할 수 있지만 중복이 있는 샤드에서는 실패할 수 있습니다. 샤드 간에 일관성 없는 인덱스가 남지 않도록 하려면 mongos에서 db.collection.dropIndex() 실행을 통해 컬렉션에서 인덱스를 삭제할 수 있습니다.

중요

순차적으로 인덱스를 빌드하는 다음 절차는 복제본 세트 배포가 아니라 샤딩된 클러스터 배포에 적용됩니다. 복제본 세트 절차에 관한 내용은 대신 복제본 세트에서의 인덱스 빌드 롤링에서 확인하세요.

mongosh 를 샤드 클러스터의 mongos 인스턴스에 연결하고 sh.stopBalancer() 를 실행하여 밸런서를 비활성화합니다: [1]

sh.stopBalancer()

참고

진행 중인 마이그레이션이 있다면, 시스템은 밸런서를 중지하기 전에 진행 중인 마이그레이션을 완료할 것입니다.

밸런서가 비활성화되었는지 확인하려면 sh.getBalancerState()를 실행하면 밸런서가 비활성화된 경우 false를 반환합니다.

sh.getBalancerState()
[1] MongoDB 6.0.3부터 자동 청크 분할이 수행되지 않습니다. 이는 밸런싱 정책이 개선되었기 때문입니다. 자동 분할 명령이 여전히 존재하지만 작업을 수행하지 않습니다. 자세한 내용은 밸런싱 정책 변경을 참조하세요. MongoDB 6.0.3 이전 버전에서 sh.stopBalancer()는 샤딩된 클러스터에 대한 자동 분할도 비활성화합니다.

mongosh 에 연결된 에서 해당 에 mongos 대해 캐시된 라우팅 테이블을 새로 mongos 고쳐 컬렉션에 대한 오래된 배포 정보가 반환되지 않도록 합니다. 새로 db.collection.getShardDistribution() 고침이 완료되면 인덱스를 빌드하려는 컬렉션에 대해 를 실행합니다.

예를 들어, test 데이터베이스의 records 컬렉션에 대한 오름차순 인덱스를 생성하려는 경우 다음과 같습니다.

db.adminCommand( { flushRouterConfig: "test.records" } );
db.records.getShardDistribution();

이 메서드는 샤드 분포를 출력합니다. 예를 들어 3개의 샤드 shardA, shardB, shardC가 있는 샤딩된 클러스터가 있고 db.collection.getShardDistribution()이 다음을 반환한다고 가정해 보겠습니다.

Shard shardA at shardA/s1-mongo1.example.net:27018,s1-mongo2.example.net:27018,s1-mongo3.example.net:27018
data : 1KiB docs : 50 chunks : 1
estimated data per chunk : 1KiB
estimated docs per chunk : 50
Shard shardC at shardC/s3-mongo1.example.net:27018,s3-mongo2.example.net:27018,s3-mongo3.example.net:27018
data : 1KiB docs : 50 chunks : 1
estimated data per chunk : 1KiB
estimated docs per chunk : 50
Totals
data : 3KiB docs : 100 chunks : 2
Shard shardA contains 50% data, 50% docs in cluster, avg obj size on shard : 40B
Shard shardC contains 50% data, 50% docs in cluster, avg obj size on shard : 40B

출력에서는 shardAshardCtest.records에 대한 인덱스만 빌드합니다.

컬렉션을 위해 청크가 포함된 각 샤드의 경우, 샤드에 인덱스를 빌드하는 절차를 따라야 합니다.

영향을 받는 샤드의 경우, 세컨더리 중 하나와 관련된 mongod 프로세스를 중지합니다. 다음 구성을 업데이트한 후 다시 시작합니다.

[2](1, 2) 다른 포트에서 mongod 실행하면 인덱스를 구축하는 동안 복제본 세트의 다른 구성원과 모든 클라이언트가 해당 구성원과 접촉하지 않도록 합니다.

새 포트에서 독립 실행형으로 실행 중인 mongod 인스턴스에 직접 연결하고 이 인스턴스에 대한 새 인덱스를 만듭니다.

예를 들어 mongosh 를 인스턴스에 연결하고 db.collection.createIndex() 메서드를 사용하여 records 컬렉션의 username 필드에 오름차순 인덱스를 생성합니다.

db.records.createIndex( { username: 1 } )

인덱스 빌드가 완료되면 mongod 인스턴스를 종료합니다. 독립형으로 시작할 때의 구성 변경 사항을 실행 취소하여 원래 구성으로 돌아가 다시 시작합니다.

중요

skipShardingConfigurationChecks 매개 변수와 disableLogicalSessionCacheRefresh 매개 변수를 제거해야 합니다.

예를 들어, 복제본 세트 샤드 멤버를 다시 시작하려면 다음을 수행합니다.

복제가 이 멤버를 따라잡을 수 있도록 허용합니다.

멤버가 세트의 다른 멤버를 따라잡으면 샤드의 나머지 세컨더리 멤버에 대해 한 번에 한 멤버씩 절차를 반복합니다.

  1. C1. 세컨더리 장치 하나를 중지하고 독립형으로 재시작

  2. C2. 인덱스 빌드

  3. C3. 복제본 세트 멤버로 프로그램 mongod 재시작

샤드의 모든 세컨더리에 새 인덱스가 있으면 샤드의 프라이머리를 강등하고 위에서 설명한 절차에 따라 독립형으로 다시 시작한 다음 이전 프라이머리에 인덱스를 빌드합니다.

  1. rs.stepDown() mongosh 의 메서드를 사용하여 프라이머리를 단계적으로 낮춥니다. 단계적 하향에 성공하면 현재 프라이머리가 세컨더리가 되고 복제본 세트 멤버는 새 프라이머리를 선택합니다.

  2. C1. 세컨더리 장치 하나를 중지하고 독립형으로 재시작

  3. C2. 인덱스 빌드

  4. C3. 복제본 세트 멤버로 프로그램 mongod 재시작

샤드에 대한 인덱스 빌드를 완료하면 영향을 받는 다른 샤드에 대해 C. 컬렉션 청크가 포함된 샤드에 인덱스 빌드를 반복합니다.

영향을 받는 샤드에 대한 롤링 인덱스 빌드가 완료되면 밸런서를 다시 시작합니다.

mongosh 를 샤드 클러스터의 mongos 인스턴스에 연결하고 sh.startBalancer() 를 실행합니다: [3]

sh.startBalancer()
[3] MongoDB 6.0.3부터 자동 청크 분할이 수행되지 않습니다. 이는 밸런싱 정책이 개선되었기 때문입니다. 자동 분할 명령이 여전히 존재하지만 작업을 수행하지 않습니다. 자세한 내용은 밸런싱 정책 변경을 참조하세요. MongoDB 6.0.3 이전 버전에서 sh.startBalancer()는 샤딩된 클러스터에 대한 자동 분할도 활성화합니다.

샤드된 컬렉션이 일관성 없는 인덱스를 가지게 되는 경우는 컬렉션에 대한 청크를 포함하는 각 샤드에 정확히 동일한 인덱스(인덱스 옵션 포함)가 없을 때입니다. 일반 작업 중에는 일관성 없는 인덱스가 발생하지 않아야 하지만,

  • 예를 들어 사용자가 unique 키 제약 조건을 사용하여 인덱스를 생성 중이고 하나의 샤드에 중복 문서가 있는 청크가 포함되어 있는 경우와 같이 일관성 없는 인덱스가 발생할 수 있습니다. 이러한 경우 인덱스 생성 작업은 중복이 없는 샤드에서는 성공할 수 있지만 중복이 있는 샤드에서는 실패할 수 있습니다.

  • 사용자가 여러 샤드에 걸쳐 인덱스를 롤링 방식으로 생성하고 있지만 연결된 샤드에 대한 인덱스를 빌드하지 못하거나 다른 사양으로 인덱스를 잘못 빌드하는 경우입니다.

config 서버 프라이머리는 주기적으로 샤드 collection에 대해 샤드 간 인덱스 불일치를 확인합니다. 이러한 주기적 검사를 구성하려면 enableShardedIndexConsistencyCheckshardedIndexConsistencyCheckIntervalMS 을(를) 참조하세요.

serverStatus 명령은 config 서버 프라이머리에서 실행될 때 인덱스 불일치를 보고하기 위해 shardedIndexConsistency 필드를 반환합니다.

샤드 컬렉션에 인덱스가 일관되지 않은지 확인하려면 샤드에서 일관되지 않은 인덱스 찾기를 참조하세요.

← 복제본 세트에 대한 롤링 인덱스 빌드