shardCollection (데이터베이스 명령)

정의

shardCollection: 컬렉션 샤드하여 여러 샤드에 문서를 배포합니다.shardCollection 명령은 admin 데이터베이스 에 대해 실행 해야 합니다.
팁
mongosh에서 이 명령은sh.shardCollection()헬퍼 메서드를 통해서도 실행 수 있습니다.
헬퍼 메서드는 사용자에게 편리하지만 데이터베이스 명령과 동일한 수준의 정보를 반환하지 않을 수 있습니다. 편의가 필요하지 않거나 추가 반환 필드가 필요한 경우 데이터베이스 명령 mongosh 사용합니다.

호환성

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

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

MongoDB Enterprise: MongoDB의 구독 기반 자체 관리 버전
MongoDB Community: MongoDB의 소스 사용 가능 무료 자체 관리 버전

구문

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

명령의 형식은 다음과 같습니다.

db.adminCommand(
   {
     shardCollection: "<database>.<collection>",
     key: { <field1>: <1|"hashed">, ... },
     unique: <boolean>,
     presplitHashedZones: <boolean>,
     collation: { locale: "simple" },
     timeseries: <object>
   }
 )

참고

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

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

명령 필드

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

필드	유형	설명
`shardCollection`	문자열	`<database>.<collection>` 형식으로 샤딩할 컬렉션의 네임스페이스입니다.
`key`	문서	샤드 키로 사용할 필드를 지정하는 문서입니다. `{ <field1>: <1\|"hashed">, ... }` 필드 값을 다음 중 하나로 설정합니다. `1` 범위 기반 샤딩의경우 `"hashed"` 해시 샤드 키를 지정합니다. 샤드 키 인덱스 에서 지원되어야 합니다. 컬렉션 비어 있는 경우가 아니라면 명령 이전에 인덱스 존재해야 `shardCollection` 합니다. 컬렉션 이 비어 있는 경우, 샤드 키 지원 수 있는 인덱스 아직 존재하지 않으면 MongoDB 컬렉션 을 샤딩 전에 인덱스 를 생성합니다. 샤드 키 인덱스도 참조하세요.
`unique`	부울	기본 인덱스가 고유한 제약 조건을 실행하도록 하려면 `true`를 지정합니다. 기본값은 `false`입니다. 해시 샤드 키를 사용할 때는 `true`를 지정할 수 없습니다.
`collation`	문서	선택 사항입니다. `shardCollection`에 지정된 컬렉션에 기본 데이터 정렬이 있는 경우 `{ locale : "simple" }`과 데이터 정렬 문서를 포함해야 하며, 그렇지 않으면 `shardCollection` 명령이 실패합니다. 샤드 키 패턴을 지원하는 필드가 있는 인덱스 중 하나 이상에는 단순 데이터 정렬이 있어야 합니다.
presplitHashedZones	부울	선택 사항입니다. 컬렉션에 정의된 구역 및 구역 범위를 기반으로 비어 있거나 존재하지 않는 컬렉션에 대해 초기 청크 생성 및 배포를 수행하려면 `true`를 지정합니다. 해시된 샤딩에만 해당됩니다. `shardCollection` `presplitHashedZones: true`는 다음 중 하나라도 참이면 오류를 반환합니다. 샤드 키에 해시된 필드가 포함되어 있지 않습니다. 즉, 단일 필드 해시 인덱스 또는 복합 해시 인덱스가 아닙니다. 컬렉션에 정의된 구역이나 구역 범위가 없습니다. 정의된 영역 범위가 요구 사항을 충족하지 않습니다.
Time Series	객체	선택 사항입니다. 새로운 분할된 Time Series 컬렉션을 생성하려면 이 옵션을 지정합니다. 기존 Time Series 컬렉션을 샤딩하려면 이 매개변수를 생략합니다. `shardCollection`에 지정된 컬렉션이 Time Series 컬렉션이고 `timeseries` 옵션이 지정되지 않은 경우 MongoDB는 기존 Time Series 컬렉션을 정의하는 값을 사용하여 `timeseries` 필드를 채웁니다. 자세한 구문은 Time Series 옵션을 참조하세요. 버전 5.1에 추가 되었습니다.

Time Series 옵션

버전 5.1에 추가 되었습니다.

샤딩된 새 time series 컬렉션 만들려면 timeseries 옵션을 로 shardCollection 지정합니다.

Time Series 옵션에는 다음 필드가 필요합니다.

필드	유형	설명
`timeField`	문자열	필수입니다. 각 time series 문서에서 날짜를 포함하는 필드의 이름입니다. time series 컬렉션의 문서에는 `timeField` 값으로 유효한 BSON 날짜가 있어야 합니다. 경고: MongoDB 8.0부터 time series 컬렉션 에서 샤드 키 `timeField` 사용이 더 이상 사용되지 않습니다.
`metaField`	문자열	선택 사항. 각 time series 문서에 메타데이터가 포함된 필드의 이름입니다. 지정된 필드의 메타데이터는 고유한 문서 시리즈에 레이블을 지정하는 데 사용되는 데이터여야 합니다. 메타데이터는 거의 변경되지 않아야 합니다. 지정된 필드의 이름은 `_id`이(가) 아니거나 `timeseries.timeField` 이름과 같지 않을 수 있습니다. 필드는 모든 데이터 유형이 가능합니다. `metaField` 필드는 선택 사항이지만 메타데이터를 사용하면 쿼리 최적화를 개선할 수 있습니다. 예를 들어 MongoDB는 새 컬렉션에 대해 `metaField` 및 `timeField` 필드에 복합 인덱스를 자동으로 생성합니다 . 이 필드에 값을 제공하지 않으면 데이터는 시간을 기준으로만 버킷됩니다.
`granularity`	문자열	선택 사항입니다. 가능한 값은 다음과 같습니다. `"seconds"` `"minutes"` `"hours"` 기본적으로 MongoDB는 고빈도 수집을 위해 `granularity`를 `"seconds"`로 설정합니다. Time Series 컬렉션의 데이터가 내부적으로 저장되는 방식을 최적화하여 성능을 향상시키려면 `granularity` 매개변수를 수동으로 설정합니다. `granularity`의 값을 선택하려면 연속 수신 측정값 사이의 시간 범위와 가장 일치하는 값을 선택합니다. `timeseries.metaField`를 지정하는 경우 `metaField` 필드에 대해 동일한 고유 값을 갖는 연속 수신 측정값 사이의 시간 범위를 고려합니다. 측정값이 동일한 소스에서 나온 경우 `metaField` 필드에 대해 동일한 고유 값을 갖는 경우가 많습니다. `timeseries.metaField`를 지정하지 않는 경우 컬렉션에 삽입된 모든 측정값 사이의 시간 범위를 고려합니다. `granularity` 매개변수를 설정하면 `bucketMaxSpanSeconds` 및 `bucketRoundingSeconds` 매개변수를 설정할 수 없습니다.

고려 사항

샤드 키

이후에 샤드 키는 변경할 수 있지만, 확장성 및 성능 문제를 피하려면 샤드 키 선택을 신중하게 고려하는 것이 중요합니다.

팁

Time Series 컬렉션의 샤드 키

시계열 컬렉션을 샤딩할 때 샤드 키에 다음 필드만 지정할 수 있습니다.

그 metaField
하위 필드 metaField
그 timeField

샤드 키에 이러한 필드의 조합을 지정할 수 있습니다. 샤드 키 패턴에는 _id를 포함한 다른 필드가 허용되지 않습니다.

샤드 키를 지정하는 경우:

metaField 가 될 수 있습니다.
- 해시된 샤드 키
- 원거리 파편 열쇠
timeField 다음과 같아야 합니다.
- 범위가 지정된 샤드 키
- 샤드 키 패턴의 끝에

팁

샤드 키로 timeField만 지정하지 마세요. timeField이 단조롭게 증가하기 때문에 클러스터 내의 단일 청크에 모든 쓰기가 표시될 수 있습니다. 이상적으로는 데이터가 여러 청크에 고르게 분산되어 있는 것이 좋습니다.

샤드 키를 가장 잘 선택하는 방법을 알아보려면 다음을 참조하세요.

경고

MongoDB 8.0부터 timeField 가 포함된 샤드 키는 time series 컬렉션에서 더 이상 사용되지 않습니다.

해시 샤드 키

해시 샤드 키는 해시 인덱스 또는 복합 해시 인덱스를 샤드 키로 사용합니다.

field: "hashed" 형식을 사용하여 해시 샤드 키 필드를 지정합니다.

참고

해시 샤드 키 컬렉션을 생성하는 동안 청크 마이그레이션이 진행 중인 경우, 밸런서가 자동으로 컬렉션의 균형을 맞출 때까지 초기 청크 분포가 고르지 않을 수 있습니다.

팁

해시 샤딩

균형을 맞추기 위한 리샤딩

명령을 실행 하면 밸런서 컬렉션 데이터를 클러스터 의 다른 샤드에 배포하기 시작합니다. 단일 샤드 한 번에 하나의 청크 마이그레이션 에만 참여할 수 있습니다. MongoDB 한 샤드 에서 다른 샤드로 데이터 범위 를 복사하는 데 성공하면 기증자 샤드 의 범위 범위 삭제기에 의해 제거 대상으로 표시됩니다. 이 프로세스 속도가 느리고 리소스 많이 사용합니다.shardCollection

MongoDB 8.0부터 배포서버 리소스 요구 사항을 충족하는 경우 reshardCollection 명령을 사용하여 동일한 키로 리샤딩하여 데이터의 초기 밸런싱을 수행하는 것이 좋습니다. 이렇게 하면 MongoDB 밸런서 에서 기다리지 않고 샤드 전체에서 데이터를 리밸런싱합니다.

reshardCollection 명령을 사용하여 초기 밸런싱을 수행하려면 다음을 수행합니다.

명령을 사용하여 컬렉션 샤딩된 컬렉션 으로 구성합니다.shardCollection
reshardCollection 를 사용하여 forceRedistribution 옵션을 true로 설정하고 동일한 샤드 키 다시 샤딩합니다. 그런 다음 MongoDB 샤드 전체에 걸쳐 데이터의 균형을 맞춥니다.

자세한 내용은 동일한 샤드 키로 리샤딩을 참조하세요.

구역 샤딩 및 초기 청크 배포

샤드 컬렉션 작업(예: shardCollection 명령 및 헬퍼)은 컬렉션 에 대해 구역 sh.shardCollection() 및 구역 범위가 정의된 경우 비어 있거나 존재하지 않는 컬렉션 에 대해 초기 청크 생성 및 배포를 수행할 수 있습니다. 초기 청크 배포를 통해 구역별 샤딩 을 더 빠르게 설정 수 있습니다. 초기 배포 후에는 밸런서 평소대로 청크 배포를 관리합니다.

복합 해시 인덱스를 사용하여 컬렉션을 샤딩하려면 구역 샤딩 및 복합 해시 인덱스를 참조하세요.

구역 샤딩 및 복합 해시 인덱스

MongoDB는 복합 해시 인덱스에 대한 샤딩 컬렉션을 지원합니다. 복합 해시 샤드 키를 사용하여 비어 있거나 존재하지 않는 컬렉션을 샤딩하는 경우 MongoDB가 초기 청크 생성 및 분산을 수행하려면 추가 요구 사항이 적용됩니다.

예를 보려면 비어 있거나 존재하지 않는 컬렉션에 대한 구역 및 구역 범위 사전 정의를 참조하세요.

팁

고유성

unique: true를 지정하는 경우:

컬렉션 이 비어 있으면 는 이러한 인덱스 아직 존재하지 않는 경우 샤드 키 에 고유 인덱스 생성합니다. shardCollection
컬렉션 이 비어 있지 않은 경우 를 사용하기 전에 먼저 인덱스 를 만들어야 shardCollection 합니다.

샤드 키가 접두사인 고유한 복합 인덱스를 가질 수 있지만 unique 매개변수를 사용하는 경우 컬렉션은 샤드 키에 있는 고유한 인덱스를 보유해야 합니다.

샤딩 컬렉션 및 고유 인덱스도 참조하세요.

데이터 정렬

컬렉션 에 기본값 데이터 정렬이 있는 경우 shardCollection 명령에는 collation 값이 인 매개 변수가 포함되어야 { locale: "simple" } 합니다. 기본값 데이터 정렬이 있는 비어 있지 않은 컬렉션의 경우 필드가 샤드 키 패턴 지원 단순 데이터 정렬이 있는 인덱스 하나 이상 있어야 합니다.

데이터 정렬이 없는 컬렉션의 경우 collation 옵션을 지정할 필요가 없습니다. 데이터 정렬이 없는 컬렉션에 대해 데이터 정렬 옵션을 지정하면 아무런 효과가 없습니다.

쓰기 고려

mongos는shardCollection명령, 해당 헬퍼sh.shardCollection()및sh.shardAndDistributeCollection()메서드의 쓰기 고려 (write concern) 에"majority"를 사용합니다.

예시

다음 작업은 records 데이터베이스의 people 컬렉션에 대해 샤딩을 사용하도록 설정하고 zipcode 필드를 샤드 키로 사용합니다.

db.adminCommand( { shardCollection: "records.people", key: { zipcode: 1 } } )

자세히 알아보기

돌아가기

setAllowMigrations

shardDrainingStatus