configureCollectionBalancing

이 페이지의 내용

정의

호환성
구문
행동
예시

정의

configureCollectionBalancing: 버전 5.3에 추가.
collection의 청크 크기 설정 및 조각 모음과 같은 샤드 collection에 대한 밸런서 설정을 구성합니다.

호환성

이 명령은 다음 환경에서 호스팅되는 배포에서 사용할 수 있습니다.

MongoDB Atlas: 클라우드에서의 MongoDB 배포를 위한 완전 관리형 서비스

참고

이 명령은 모든 MongoDB Atlas 클러스터에서 지원됩니다. 모든 명령에 대한 Atlas 지원에 관해 자세히 알아보려면 지원되지 않는 명령을 참조하십시오.

MongoDB Enterprise: MongoDB의 구독 기반 자체 관리 버전
MongoDB Community: MongoDB의 소스 사용 가능 무료 자체 관리 버전

구문

명령은 다음과 같은 구문을 가집니다:

db.adminCommand(
   {
     configureCollectionBalancing: "<db>.<collection>",
     chunkSize: <num>,
     defragmentCollection: <bool>
     enableAutoMerger: <bool>
   }
)

명령 필드

configureCollectionBalancing 에는 다음과 같은 필드가 있습니다:

필드	유형	필요성	설명
`configureCollectionBalancing`	문자열	필수 사항	구성할 데이터베이스 및 샤드 collection의 이름입니다.
`chunkSize`	integer	옵션	컬렉션 의 청크 크기(MiB)를 설정합니다. 권장 크기는 256, 512 이상입니다. 기본값 동작에 대한 자세한 내용은 chunkSize가 지정되지 않은 경우 기본 동작을 참조하세요.
`defragmentCollection`	부울	옵션	밸런서가 collection 조각 모음을 수행하도록 합니다. 기본값은 `false` 입니다.
`enableAutoMerger`	부울	옵션	AutoMerger 가 이 컬렉션을 고려하는지 여부입니다. 기본값은 `true` 입니다.

자세한 내용 은 청크를 사용한 데이터 분할을 참조하세요.

청크 조각 모음 스로틀 시간 매개 변수를 구성하려면 chunkDefragmentationThrottlingMS 를 참조하세요.

샤드된 컬렉션 조각 모음에 대해 자세히 알아보려면 샤드된 컬렉션 조각모음을 참조하세요.

행동

청크 크기가 지정되지 않은 경우 기본 동작

collection에 chunkSize 를 지정하지 않았고 이전에 사용자 정의 크기를 설정한 적이 없는 경우, 글로벌 기본 chunkSize 밸런싱이 사용됩니다.

청크 크기 지정: 0

configureCollectionBalancing을 chunkSize: 0과 함께 사용하면 컬렉션별 chunkSize가 재설정되고 전역 기본 chunkSize가 밸런싱에 사용됩니다.

기본 chunkSize 구성에 대한 자세한 내용 은 샤드 클러스터에서 범위 크기 수정을 참조하세요.

enableAutoMerger가 지정되지 않은 경우 기본 동작

컬렉션에 대해 enableAutoMerger 을 지정하지 않고 이전에 설정된 사용자 지정 자동 병합 동작이 없는 경우, 기본값은 true 이며 AutoMerger에서 이를 고려합니다.

예시

청크 크기 구성

샤드 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 조각 모음에 대해 자세히 알아보려면 샤드 collection 조각 모음을 참조하세요.

collection 재구성 및 조각 모음

청크 크기를 업데이트하면서 샤딩된 컬렉션을 조각 모음하려면 defragmentCollection 옵션과 chunkSize 옵션을 함께 사용합니다.

db.adminCommand( {
   configureCollectionBalancing: "test.students",
   chunkSize: 512,
   defragmentCollection: true
} )

collection에서 자동 병합 비활성화

collection에서 AutoMerger를 명시적으로 비활성화하려면 enableAutoMerger 옵션을 false 로 설정합니다.

db.adminCommand( {
   configureCollectionBalancing: "test.students",
   enableAutoMerger: false
} )

돌아가기

commitReshardCollection

configureQueryAnalyzer