sh.shardCollection()

정의

sh.shardCollection(namespace, key, unique, options)

key 를 샤드 키로 사용하여 컬렉션을 샤드합니다. 샤드 키는 MongoDB가 컬렉션 문서를 샤드에 배포하는 방법을 결정합니다.

참고

버전 6.0에서 변경되었습니다.

MongoDB 6.0부터는 컬렉션을 샤딩할 때 sh.enableSharding() 메서드를 먼저 실행하여 데이터베이스를 구성할 필요가 없습니다.

중요

Mongo쉬 방법

이 페이지에서는 mongosh 메서드를 설명합니다. 이는 데이터베이스 명령 또는 Node.js와 같은 언어별 드라이버에 대한 설명서가 아닙니다.

데이터베이스 명령에 대해서는 shardCollection 명령을 참조하십시오.

MongoDB API 드라이버의 경우 언어별 MongoDB 드라이버 설명서를 참조하세요.

레거시 mongo 셸 문서는 해당 MongoDB 서버 릴리스 문서를 참조하세요.

Mongo 셸 V4.4

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

매개 변수	유형	설명
namespace	문자열	"<database>.<collection>" 형식으로 샤딩할 컬렉션의 네임스페이스입니다.
key	문서	샤드 키로 사용할 필드를 지정하는 문서입니다. { <field1>: <1|"hashed">, ... } 필드 값을 둘 중 하나로 설정합니다. 1 범위 기반 샤딩의 경우 "hashed" 해시 샤드 키를 지정합니다. 샤드 키는 인덱스에서 지원되어야 합니다. 컬렉션이 비어 있는 경우가 아니라면 shardCollection 명령 이전에 인덱스가 존재해야 합니다. 컬렉션이 비어 있는 경우, 샤드 키를 지원할 수 있는 인덱스가 아직 존재하지 않으면 MongoDB는 컬렉션을 샤딩하기 전에 인덱스를 생성합니다. 샤드 키 인덱스도 참조하세요.
unique	부울	선택 사항입니다. 기본 인덱스가 고유한 제약 조건을 실행하도록 하려면 true를 지정합니다. 기본값은 false입니다. 해시 샤드 키를 사용할 때는 true를 지정할 수 없습니다. options 문서를 지정하는 경우 unique의 값을 명시적으로 지정해야 합니다.
options	문서	선택 사항. numInitialChunks 및 collation을 포함한 선택적 필드가 포함된 문서입니다.

options 인수는 다음 옵션을 지원합니다.

매개 변수	유형	설명
numInitialChunks	integer	선택 사항입니다. 해시 샤드 키로 빈 컬렉션을 샤딩할 때 처음에 생성할 청크의 최소 개수를 지정합니다. 그런 다음 MongoDB는 클러스터 전체에 청크를 생성하고 균형을 맞춥니다. numInitialChunks 매개변수는 샤드당 8192 청크보다 작아야 합니다. 기본값은 샤드당 2 청크입니다. 컬렉션이 비어 있지 않거나 샤드 키에 해시된 필드가 포함되어 있지 않으면 작업에서 오류를 반환합니다. presplitHashedZones: true로 샤딩하는 경우, MongoDB는 클러스터의 구역에 지정된 수의 청크를 균등하게 분배하려고 시도합니다. presplitHashedZones: false 또는 생략으로 샤딩하고 빈 컬렉션에 대해 구역 및 구역 범위가 정의되지 않은 경우, MongoDB는 클러스터의 샤드에 지정된 수의 청크를 균등하게 분산하려고 시도합니다. presplitHashedZones: false 또는 생략으로 샤딩하고 빈 컬렉션에 대해 구역 및 구역 범위가 정의된 경우 numInitChunks (은)는 효과가 없습니다.
collation	문서	선택 사항입니다. shardCollection에 지정된 collection에 기본값 데이터 정렬이 있는 경우 ``{ locale : "simple" }``(이)가 포함된 데이터 정렬 문서를 포함해야 하며, 그렇지 않으면 shardCollection 명령이 실패합니다. 샤드 키 패턴을 지원하는 필드가 있는 인덱스 중 하나 이상에는 단순 데이터 정렬이 있어야 합니다.
presplitHashedZones	부울	선택 사항입니다. 컬렉션에 정의된 구역 및 구역 범위를 기반으로 비어 있거나 존재하지 않는 컬렉션에 대해 초기 청크 생성 및 배포를 수행하려면 true를 지정합니다. 해시된 샤딩에만 해당됩니다. shardCollection() presplitHashedZones: true는 다음 중 하나라도 참이면 오류를 반환합니다. 샤드 키에 해시된 필드가 포함되어 있지 않습니다. 즉, 단일 필드 해시 인덱스 또는 복합 해시 인덱스가 아닙니다. 컬렉션에 정의된 구역이나 구역 범위가 없습니다. 정의된 구역 범위가 요구 사항을 충족하지 않습니다.
Time Series	문서	선택 사항입니다. 새로운 분할된 Time Series 컬렉션을 생성하려면 이 옵션을 지정합니다. 기존 Time Series 컬렉션을 샤딩하려면 이 매개변수를 생략합니다. shardCollection에 지정된 컬렉션이 Time Series 컬렉션이고 timeseries 옵션이 지정되지 않은 경우 MongoDB는 기존 Time Series 컬렉션을 정의하는 값을 사용하여 timeseries 필드를 채웁니다. 자세한 구문은 Time Series 옵션을 참조하세요.

고려 사항

일단 컬렉션이 샤딩되고 나면 MongoDB는 샤드 컬렉션의 샤딩을 되돌리는 메서드를 제공하지 않습니다.

예제

sh.shardCollection("records.people", { zipcode: 1 } )

sh.shardCollection(
  "phonebook.contacts",
  { last_name: "hashed" },
  false,
  {
    numInitialChunks: 5,
    collation: { locale: "simple" }
  }
)