BalancerStop
정의
balancerStop
샤드 cluster에서 밸런서를 비활성화합니다. 밸런싱 라운드가 진행 중인 경우, 작업은 밸런싱이 완료될 때까지 기다립니다.
인스턴스 의
mongos
balancerStop
admin
데이터베이스 에 대해서만 를 실행할 수 있습니다.중요
밸런서 를 장기간 비활성화된 상태로 두면 샤드의 균형이 맞지 않아 클러스터 성능이 저하될 수 있습니다. 필요한 경우에만 밸런서 를 비활성화하고, 유지 관리가 완료되면 밸런서 를 다시 활성화해야 합니다.
팁
mongosh
에서 이 명령을sh.stopBalancer()
헬퍼 메서드를 통해서도 실행할 수 있습니다.헬퍼 메서드는
mongosh
사용자에게 편리하지만 데이터베이스 명령과 동일한 수준의 정보를 반환하지 못할 수 있습니다. 편의가 필요하지 않거나 추가 리턴 필드가 필요한 경우 데이터베이스 명령을 사용합니다.MongoDB 6.0.3부터 자동 청크 분할이 수행되지 않습니다. 이는 밸런싱 정책 개선 때문입니다. 자동 분할 명령이 여전히 존재하지만 작업을 수행하지 않습니다.
6.1 이전 MongoDB 버전에서는 이 명령이 샤딩된 cluster에 대한 자동 분할을 비활성화합니다. 밸런서가 비활성화되었을 때 자동 분할을 활성화하려면
sh.enableAutoSplit()
을(를) 사용할 수 있습니다.
호환성
이 명령은 다음 환경에서 호스팅되는 배포에서 사용할 수 있습니다.
MongoDB Atlas: 클라우드에서의 MongoDB 배포를 위한 완전 관리형 서비스
중요
이 명령은 서버리스 인스턴스에서는 지원되지 않습니다. 자세한 내용은 지원되지 않는 명령을 참조하세요.
MongoDB Enterprise: MongoDB의 구독 기반 자체 관리 버전
MongoDB Community: MongoDB의 소스 사용 가능 무료 자체 관리 버전
구문
명령은 다음과 같은 구문을 가집니다:
db.adminCommand( { balancerStop: 1, maxTimeMS: <number> } )
명령 필드
필드 | 유형 | 설명 |
---|---|---|
balancerStop | any | 모든 값. |
maxTimeMS | integer | 밸런서를 비활성화하는 데 걸리는 시간 제한입니다. 기본값은 60000밀리초입니다. |
예시
밸런서 스레드를 중지하려면 mongos
인스턴스에 연결하고 다음 명령을 실행합니다.
db.adminCommand( { balancerStop: 1 } )