configureCollectionBalancing
정의
호환성
이 명령은 다음 환경에서 호스팅되는 배포에서 사용할 수 있습니다.
MongoDB Atlas: 클라우드에서의 MongoDB 배포를 위한 완전 관리형 서비스
참고
이 명령은 모든 MongoDB Atlas 클러스터에서 지원됩니다. 모든 명령에 대한 자세한 내용은 지원되지 않는 명령을 참조하세요.
MongoDB Enterprise: MongoDB의 구독 기반 자체 관리 버전
MongoDB Community: MongoDB의 소스 사용 가능 무료 자체 관리 버전
구문
명령은 다음과 같은 구문을 가집니다:
db.adminCommand( { configureCollectionBalancing: "<db>.<collection>", chunkSize: <num>, defragmentCollection: <bool> } )
명령 필드
configureCollectionBalancing 에는 다음과 같은 필드가 있습니다:
필드 | 유형 | 설명 |
|---|---|---|
configureCollectionBalancing | 문자열 | 필수: 구성할 데이터베이스 및 샤드 collection의 이름입니다. |
chunkSize | integer | 선택 사항: collection의 청크 크기(MiB)를 설정합니다. 권장 크기는 256, 512 이상입니다. |
defragmentCollection | 부울 | 선택 사항: 밸런서가 collection 조각 모음을 수행하도록 합니다. |
자세한 내용 은 청크를 사용한 데이터 분할을 참조하세요.
행동
chunkSize 컬렉션 이 지정되지 않았습니다.
collection에 chunkSize 를 지정하지 않았고 이전에 사용자 정의 크기를 설정한 적이 없는 경우, 글로벌 기본 chunkSize 밸런싱이 사용됩니다.
지정 chunkSize: 0
configureCollectionBalancing을 chunkSize: 0과 함께 사용하면 컬렉션별 chunkSize가 재설정되고 전역 기본 chunkSize가 밸런싱에 사용됩니다.
기본 chunkSize 구성에 대한 자세한 내용 은 샤드 클러스터에서 범위 크기 수정을 참조하세요.
예제
청크 크기 구성
샤드 collection의 청크 크기를 변경하려면 chunkSize 옵션을 사용합니다.
db.adminCommand( { configureCollectionBalancing: "test.students", chunkSize: 256 } )
이 명령을 사용하여 지정된 collection의 청크 크기를 변경합니다.
경고
청크의 문서 수가 구성된 청크 크기를 평균 문서 크기로 나눈 결과의 2 배보다 크면 기본적으로 MongoDB는 청크를 이동할 수 없습니다.
평균 문서 크기를 찾으려면 db.collection.stats() 메서드의 출력에서 avgObjSize 필드를 참조하세요.
자세한 내용은 범위 크기를 참조하세요.
collection 조각 모음
경고
MongoDB 6.0.0에서 6.0.3으로 및 MongoDB 6.1.0의 경우 defragmentCollection 를 사용하여 샤딩된 collection의 조각 모음을 수행하지 않는 것이 좋습니다. 6.1.1로, 이는 이러한 릴리스의 조각 모음 프로세스로 인해 데이터베이스와 collection을 장기간 사용할 수 없게 될 수 있기 때문입니다.
밸런서에 샤드 collection의 조각 모음을 지시하려면 defragmentCollection 옵션을 사용하세요.
db.adminCommand( { configureCollectionBalancing: "test.students", defragmentCollection: true } )
Use this command to have the balancer defragment a sharded collection. 청크 조각 모음 프로세스를 모니터링하려면 balancerCollectionStatus 명령을 사용합니다.
collection 재구성 및 조각 모음
청크 크기를 업데이트하면서 샤딩된 컬렉션을 조각 모음하려면 defragmentCollection 옵션과 chunkSize 옵션을 함께 사용합니다.
db.adminCommand( { configureCollectionBalancing: "test.students", chunkSize: 512, defragmentCollection: true } )