문서 메뉴
문서 홈
/
MongoDB 매뉴얼
/ / /

configureCollectionBalancing

이 페이지의 내용

  • 정의
  • 구문
  • 행동
  • 예제
configureCollectionBalancing

버전 5.3에 추가.

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

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

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 밸런싱이 사용됩니다.

configureCollectionBalancingchunkSize: 0 와 함께 사용하면 컬렉션별 chunkSize 가 재설정되고 글로벌 기본값 chunkSize 이 밸런싱에 사용됩니다.

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

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

샤드 collection의 청크 크기를 변경하려면 chunkSize 옵션을 사용합니다.

db.adminCommand( {
configureCollectionBalancing: "test.students",
chunkSize: 256
} )

이 명령을 사용하여 지정된 collection의 청크 크기를 변경합니다.

경고

기본적으로 MongoDB는 청크의 문서 수가 구성된 청크 크기를 평균 문서 크기로 나눈 결과의 1.3배보다 크면 청크를 이동할 수 없습니다.

평균 문서 크기를 찾으려면 db.collection.stats() 메서드의 출력에서 avgObjSize 필드를 참조하세요.

자세한 내용은 범위 크기를 참조하세요.

경고

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 조각 모음을 참조하세요.

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

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

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

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

이 페이지의 내용