updateZoneKeyRange

정의

updateZoneKeyRange

버전 3.4에 새로 추가되었습니다.

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

MongoDB 4 부터 시작.0.2, updateZoneKeyRange 데이터베이스 명령과 해당 헬퍼 sh.updateZoneKeyRange() 및 sh.addTagRange() 를 비샤드형 컬렉션 또는 존재하지 않는 컬렉션에서 실행할 수 있습니다.

팁

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

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

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

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

updateZoneKeyRange 명령의 구문은 다음과 같습니다.

{
  updateZoneKeyRange: <string>,
  min: <document>,
  max: <document>,
  zone: <string> | <null>
}

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

매개변수	유형	설명
updateZoneKeyRange	문자열	범위와 연결할 collection의 네임스페이스입니다. 명령이 성공하려면 collection을 샤딩해야 합니다.
min	문서	샤드 키 값 범위의 포괄적 하한입니다. 샤드 키의 각 필드를 <fieldname> : <value> 형식으로 지정합니다. 값은 샤드 키와 동일한 BSON 유형이어야 합니다. 참고 해시 샤딩을 사용하려면 필드 값이 NumberLong 유형이어야 합니다.
max	문서	샤드 키 값 범위의 배타적 상한입니다. 샤드 키의 각 필드를 <fieldname> : <value> 형식으로 지정합니다. 값은 샤드 키와 동일한 BSON 유형이어야 합니다. 참고 해시 샤딩을 사용하려면 필드 값이 NumberLong 유형이어야 합니다.
zone	문자열	min 및 max 으로 묶인 범위와 연결할 구역의 이름입니다. 값이 기존 구역과 일치하지 않으면 명령이 실패합니다. min 의 하한과 max 의 상한이 있는 범위와 updateZoneKeyRange collection 간의 연결을 제거하려면 null 을 지정합니다. min 및 max 값은 대상 범위와 정확히 일치해야 합니다.

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

  또는,

• cluster 리소스에 대한 가 enableSharding 포함된 권한을 가진 사용자(버전 4.2.2, 4.0.14, 3.6.16부터 사용 가능).

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"
   }
)