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