addShardToZone

정의

addShardToZone

샤드 를 구역 과 연결합니다. MongoDB 는 이 샤드 를 지정된 구역 과 연결합니다. 구역 에 포함되는 청크는 구역 과 관련된 샤드에 할당됩니다.

팁

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

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

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

호환성

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

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

• MongoDB Enterprise: MongoDB의 구독 기반 자체 관리 버전

• MongoDB Community: MongoDB의 소스 사용 가능 무료 자체 관리 버전

구문

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

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

행동

구역을 여러 샤드와 연결할 수 있으며, 하나의 샤드가 여러 구역과 연결할 수 있습니다.

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

보안

액세스 제어 를 적용하는 샤드 cluster의 경우 다음 중 하나의 권한을 가진 사용자로 인증해야 합니다.

• update config 데이터베이스의 shards collection에 대한 , 또는,

• enableSharding 클러스터 리소스의 .

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

예시

다음 예에서는 shard0000 을 JFK 구역과 연결합니다.

db.adminCommand( { addShardToZone : "shard0000" , zone : "JFK" } )

샤드는 여러 구역과 연결할 수 있습니다. 다음 예에서는 LGA 을 shard0000 에 연결합니다.

db.adminCommand( { addShardToZone : "shard0000" , zone : "LGA" } )

shard0000 LGA 구역 및 JFK 구역과 모두 연결됩니다. 균형 잡힌 cluster에서 MongoDB는 두 구역 중 하나에 포함되는 읽기 및 쓰기를 shard0000 으로 라우팅합니다.