Docs Menu
Docs Home
/
MongoDB 매뉴얼
/ / /

removeShardFromZone

이 페이지의 내용

  • 정의
  • 호환성
  • 구문
  • 명령 필드
  • 행동
  • 예시
removeShardFromZone

removeShardFromZone 관리 명령은 샤드 와 구역 간의 연결을 제거합니다.

mongosh에서 이 명령을 sh.removeShardFromZone() 헬퍼 메서드를 통해서도 실행할 수 있습니다.

헬퍼 메서드는 mongosh 사용자에게 편리하지만 데이터베이스 명령과 동일한 수준의 정보를 반환하지 못할 수 있습니다. 편의가 필요하지 않거나 추가 리턴 필드가 필요한 경우 데이터베이스 명령을 사용합니다.

이 명령은 다음 환경에서 호스팅되는 배포에서 사용할 수 있습니다.

  • MongoDB Atlas: 클라우드에서의 MongoDB 배포를 위한 완전 관리형 서비스

중요

이 명령은 서버리스 인스턴스에서는 지원되지 않습니다. 자세한 내용은 지원되지 않는 명령을 참조하세요.

removeShardFromZone 인스턴스의 admin 데이터베이스에서만 를 mongos 실행할 수 있습니다.

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

db.adminCommand(
{
removeShardFromZone: <string>,
zone: <string>
}
)

이 명령은 다음 필드를 사용합니다.

필드
유형
설명
문자열

구역 연결을 제거할 샤드의 이름입니다.

문자열

제거하려는 샤드 와의 연결이 있는 영역의 이름입니다.

mongosh 은(는) 헬퍼 메서드 sh.removeShardFromZone() 을(를) 제공합니다.

removeShardFromZone 구역과 관련된 범위는 제거하지 않습니다.

클러스터에서 구역을 완전히 제거하려면 해당 구역과 연결된 각 샤드에서 removeShardFromZone 를 실행해야 합니다.

지정된 샤드가 구역과 연결된 마지막 샤드인 경우, 해당 구역과 연결된 샤드 키 범위가 남아 있지 않은지 확인해야 합니다. updateZoneKeyRange 를 사용하여 removeShardFromZone 를 실행하기 전에 구역과 연결된 기존 범위를 제거합니다.

샤드 클러스터의 구역에 대한 자세한 내용은 구역 매뉴얼 페이지를 참조하세요.

액세스 제어 를 적용하는 샤드 cluster의 경우 다음 중 하나를 사용하여 인증해야 합니다.

  • 다음과 같은 권한을 가진 사용자입니다.

    • update 데이터베이스의 shards collection config 컬렉션에 대한 및

    • find config 데이터베이스의 tags collection에 대한 ,

    또는

  • 클러스터 리소스에 대한 가 enableSharding 포함된 권한을 가진 사용자입니다.

clusterAdmin 또는 clusterManager 기본 제공 역할에는 removeShardFromZone 발급에 적합한 권한이 있습니다. 자세한 내용은 역할 기반 액세스 제어 매뉴얼 페이지를 참조하세요.

다음 예에서는 shard0000 와 구역 NYC 간의 연결을 제거합니다.

db.adminCommand( { removeShardFromZone : "shard0000" , zone : "NYC" } )

돌아가기

removeShard