문서 메뉴

문서 홈 → 애플리케이션 개발 → MongoDB 매뉴얼

sh.addTagRange()

이 페이지의 내용

  • 정의
  • 행동
  • 예제

정의

sh.addTagRange(namespace, minimum, maximum, tag)

버전 3 에서 변경되었습니다.4: 이 메서드의 별칭은 MongoDB 3 에서 sh.updateZoneKeyRange() 입니다.4. 아래에 지정된 기능은 여전히 MongoDB 3 에 적용됩니다.2. MongoDB 3.4 은 태그 인식 샤딩의 후속으로 구역 샤딩 을 제공합니다.

sh.addShardTag() 메서드를 사용하여 생성된 샤드 태그에 샤드 키 값 범위를 연결합니다.

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

sh.addTagRange() 다음 인수를 사용합니다.

매개변수
유형
설명
namespace
문자열
태그를 지정할 샤드 collection의 네임스페이스 입니다.
minimum
문서
The minimum value of the shard key range to include in the tag. 최소값은 포괄적 일치입니다. Specify the minimum value in the form of <fieldname>:<value>. 이 값은 샤드 키와 동일한 BSON types여야 합니다.
maximum
문서
태그에 포함할 샤드 키 범위의 최대값입니다. 최대값은 독점 일치입니다. <fieldname>:<value> 형식으로 최대값을 지정합니다. 이 값은 샤드 키와 동일한 BSON types여야 합니다.
tag
문자열
minimum 및 maximum 인수로 지정된 범위를 연결할 태그의 이름입니다.

sh.addShardTag() 를 사용하여 밸런서가 지정된 범위 내에 존재하는 문서를 특정 샤드 또는 샤드 세트로 마이그레이션하도록 합니다.

sh.addTagRange() 인스턴스에 연결된 경우에만 를 실행합니다.mongos

행동

바운드

구역 범위는 항상 하한 경계를 포함하고 상한 경계를 제외합니다.

비어 있거나 존재하지 않는 컬렉션에 대한 초기 청크 배포

비어 있거나 존재하지 않는 컬렉션에 대해 구역 샤딩 을 수행하려는 경우, 컬렉션을 샤딩 하기 전에 를 사용하여 구역 sh.addTagRange() 및 구역 범위를 생성합니다. 버전 4 부터0 시작됩니다. .3, 비어 있거나 존재하지 않는 컬렉션에 구역 및 구역 범위를 생성하면 MongoDB가 컬렉션을 샤딩할 때 초기 청크 생성 및 배포 프로세스를 최적화할 수 있습니다. 이 최적화된 프로세스는 샤딩 후 구역을 생성하는 것보다 적은 밸런서 오버헤드로 구역 샤딩을 더 빠르게 설정할 수 있도록 지원합니다.밸런서 는 최적화된 초기 청크 생성 및 배포 후 모든 청크 관리를 수행합니다.

초기 청크 배포를 위한 구역 및 구역 범위를 정의하는 예 는 비어 있거나 존재하지 않는 collection에 대한 구역 및 구역 범위 사전 정의를 참조하세요.

복합 해시 샤드 키를 사용한 초기 청크 배포

MongoDB는 복합 해시 인덱스에서 collection 샤딩을 지원합니다. MongoDB는 복합 해시 샤드 키에서 비어 있거나 존재하지 않는 collection을 샤딩할 때 최적화된 초기 청크 생성 및 배포를 수행할 수 있습니다.

복합 해시 샤드 키의 초기 청크 배포를 위한 구역 및 구역 범위를 정의하는 더 완전한 예시 는 비어 있거나 존재하지 않는 컬렉션에 대한 구역 및 구역 범위 사전 정의를 참조하세요.

삭제된 컬렉션

컬렉션을 삭제하면 관련된 영역/태그 범위가 삭제됩니다.

이전 버전에서는 MongoDB가 삭제된 컬렉션에 대한 태그 연결을 제거하지 않았으며, 나중에 같은 이름으로 새 컬렉션을 만들면 이전 태그 연결이 새 컬렉션에 적용됩니다.

예제

샤드 키가 {state: 1, zip: 1} 주어지면 다음 작업은 뉴욕주의 우편번호를 포함하는 태그 범위를 생성합니다.

sh.addTagRange( "exampledb.collection",
                { state: "NY", zip: MinKey },
                { state: "NY", zip: MaxKey },
                "NY"
              )
← sh.addShardToZone()
sh.balancerCollectionStatus() →

이 페이지의 내용