removeShardFromZone
정의
removeShardFromZone
버전 3.4에 새로 추가되었습니다.
removeShardFromZone
관리 명령은 샤드 와 구역 간의 연결을 제거합니다.팁
mongosh
에서 이 명령을sh.removeShardFromZone()
헬퍼 메서드를 통해서도 실행할 수 있습니다.헬퍼 메서드는
mongosh
사용자에게 편리하지만 데이터베이스 명령과 동일한 수준의 정보를 반환하지 못할 수 있습니다. 편의가 필요하지 않거나 추가 리턴 필드가 필요한 경우 데이터베이스 명령을 사용합니다.
호환성
이 명령은 다음 환경에서 호스팅되는 배포에서 사용할 수 있습니다.
MongoDB Atlas: 클라우드에서의 MongoDB 배포를 위한 완전 관리형 서비스
중요
이 명령은 서버리스 인스턴스에서는 지원되지 않습니다. 자세한 내용은 지원되지 않는 명령을 참조하세요.
MongoDB Enterprise: MongoDB의 구독 기반 자체 관리 버전
MongoDB Community: MongoDB의 소스 사용 가능 무료 자체 관리 버전
구문
removeShardFromZone
인스턴스의 admin
데이터베이스에서만 를 mongos
실행할 수 있습니다.
removeShardFromZone
명령의 구문은 다음과 같습니다.
db.adminCommand( { removeShardFromZone: <string>, zone: <string> } )
이 명령은 다음 필드를 사용합니다.
mongosh
은(는) 헬퍼 메서드 sh.removeShardFromZone()
을(를) 제공합니다.
행동
removeShardFromZone
구역과 관련된 범위는 제거하지 않습니다.
클러스터에서 구역을 완전히 제거하려면 해당 구역과 연결된 각 샤드에서 removeShardFromZone
를 실행해야 합니다.
지정된 샤드가 구역과 연결된 마지막 샤드인 경우, 해당 구역과 연결된 샤드 키 범위가 남아 있지 않은지 확인해야 합니다. updateZoneKeyRange
를 사용하여 removeShardFromZone
를 실행하기 전에 구역과 연결된 기존 범위를 제거합니다.
샤드 클러스터의 구역에 대한 자세한 내용은 구역 매뉴얼 페이지를 참조하세요.
보안
액세스 제어 를 적용하는 샤드 cluster의 경우 다음 중 하나를 사용하여 인증해야 합니다.
다음과 같은 권한을 가진 사용자입니다.
또는
클러스터 리소스에 대한 가
enableSharding
포함된 권한을 가진 사용자입니다.
clusterAdmin
또는 clusterManager
기본 제공 역할에는 removeShardFromZone
발급에 적합한 권한이 있습니다. 자세한 내용은 역할 기반 액세스 제어 매뉴얼 페이지를 참조하세요.
예시
다음 예에서는 shard0000
와 구역 NYC
간의 연결을 제거합니다.
db.adminCommand( { removeShardFromZone : "shard0000" , zone : "NYC" } )