updateZoneKeyRange

정의

updateZoneKeyRange

updateZoneKeyRange 관리 명령은 샤드 키 값 범위 와 구역간의 연결을 만들거나 제거 할 수 있습니다.

updateZoneKeyRange 데이터베이스 명령 과 해당 헬퍼 sh.updateZoneKeyRange() 및 sh.addTagRange() 를 샤딩되지 않은 컬렉션 또는 존재하지 않는 컬렉션 에서 실행 수 있습니다.

팁

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

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

updateZoneKeyRange를 실행하려면 db.runCommand( { <command> } ) 메서드를 사용합니다.

관리 데이터베이스에서 addShardToZone 을(를) 실행해야 합니다.

호환성

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

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

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

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

구문

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

db.adminCommand(
   {
     updateZoneKeyRange: <string>,
     min: <document>,
     max: <document>,
     zone: <string> | <null>
   }
)

명령 필드

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

행동

updateZoneKeyRange 에 전달된 최소 및 최대 경계와 일치하는 구역 범위가 없는 경우 아무것도 제거되지 않습니다.

updateZoneKeyRange 인스턴스에 연결된 경우에만 를 실행합니다.mongos

mongosh 는 두 가지 헬퍼 메서드를 제공합니다.

• sh.updateZoneKeyRange() 구역에 샤드 키 값 범위를 추가합니다.

• sh.removeRangeFromZone() 를 사용하여 구역에서 특정 범위의 샤드 키 값을 제거할 수 있습니다.

샤드 컬렉션의 기존 범위와 하한선 및 상한선이 겹치는 샤드 키 값 범위는 생성할 수 없습니다. 예를 들어 기존 범위가 1 ~ 10 인 경우 새 범위가 기존 범위와 겹치므로 5 ~ 20 의 새 범위를 만들 수 없습니다.

구역은 여러 범위의 데이터와 연결될 수 있지만 범위는 최대 단일 구역과 연결될 수 있습니다.

범위와 구역 간의 연결을 제거할 때 updateZoneKeyRange 는 구역을 제거하지 않습니다. removeShardFromZone 명령을 사용하여 구역과 샤드 간의 연결을 제거합니다.

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

보안

authentication 으로 실행되는 샤드 클러스터의 경우 다음 중 하나를 사용하여 인증해야 합니다.

• config 데이터베이스의 다양한 컬렉션에 대해 지정된 작업이 포함된 권한을 가진 사용자입니다.

  • find 컬렉션의 config.shards {

  • collection의find, update 및 remove 입니다.config.tags

  또는,

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

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

예시

샤드 키가 { a : 1 } 인 샤드 컬렉션 exampledb.collection 이 주어지면 다음 작업은 alpha 구역에 하한이 1 이고 상한이 10 인 범위를 생성합니다.

admin = db.getSiblingDB("admin")
admin.runCommand(
   {
      updateZoneKeyRange : "exampledb.collection",
      min : { a : 1 },
      max : { a : 10 },
      zone : "alpha"
   }
)

다음 작업은 null 을 zone 필드에 전달하여 이전에 생성된 범위를 제거합니다.

admin = db.getSiblingDB("admin")
admin.runCommand(
   {
      updateZoneKeyRange : "exampledb.collection",
      min : { a : 1 },
      max : { a : 10 },
      zone : null
   }
)

min 및 max 는 대상 범위의 경계와 정확히 일치해야 합니다. 다음 작업은 이전에 생성된 범위를 제거하려고 시도하지만 { a : 0 } 를 min 바운드로 지정합니다.

admin = db.getSiblingDB("admin")
admin.runCommand(
   {
      updateZoneKeyRange : "exampledb.collection",
      min : { a : 0 },
      max : { a : 10 },
      zone : null
   }
)

{ a : 0 } 및 { a : 10 } 범위는 기존 범위를 포함하지만 정확히 일치하지 않으므로 updateZoneKeyRange 는 아무것도 제거하지 않습니다.

admin = db.getSiblingDB("admin")
admin.runCommand(
   {
      updateZoneKeyRange : "exampledb.collection",
      min : { a : 1, b : 1 },
      max : { a : 10, b : 10 },
      zone : "alpha"
   }
)