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