RefineCollectionShardKey(데이터베이스 명령)

인덱스 고려 사항

• 인덱스 존재 여부

  명령을 실행 하기 전에 명령에 지정된 키 를 지원하는 인덱스가 존재해야 합니다.

  지원 인덱스는 새 샤드 키 사양으로 시작하는 인덱스입니다. 즉, 인덱스 접두사 가 새 샤드 키 사양과 일치합니다. 즉, 샤드 키를 로 변경하려면 { x: 1, y: 1 } { x: 1 }로 시작하는 인덱스가 { x: 1, y: 1 } 있어야 합니다. 예

  • { x: 1, y: 1 }

  • { x: 1, y: 1, a: 1, b: 1}

  참고

  • 지원 인덱스는 부분 인덱스가 될 수 없습니다.

  • 지원 인덱스는 희소 인덱스일 수 없습니다.

  • If the collection에서simple 이 아닌 데이터 정렬을 사용하는 경우 지원 인덱스는 { locale: "simple" } 데이터 정렬을 지정해야 합니다.

• 고유 인덱스

  현재 샤드 인덱스에 고유성 제약 조건 이 있는 경우 새 샤드 키 인덱스에도 고유성 제약 조건이 있어야 합니다.

  새 샤드 키를 지원하기 위해 고유 인덱스를 refineCollectionShardKey 생성한 후 를실행 하기 전에 이전 샤드 키 인덱스를 삭제 합니다.

  또한 현재 샤드 인덱스에 고유 제약 조건 이 있는 경우 새 샤드 키에는 해당 필드에 "hashed" 를 지정할 수 없습니다.

  Sharded collection 및 고유 인덱스를 참조하세요.

• 인덱스 데이터 정렬

  샤딩된 collection에simple 이 아닌 기본 데이터 정렬 이 있는 경우 인덱스에는 { locale : "simple" } 가 있는 데이터 정렬 문서가 포함 되어야 합니다 . 샤드 키 패턴을 지원하는 필드가 있는 인덱스 중 하나 이상에는 단순 데이터 정렬이 있어야 합니다.

simple 이 아닌 데이터 정렬을 사용한 컬렉션

test 데이터베이스에서 예시를 설정하려면 다음을 수행합니다.

1. 프랑스어 fr 를 기본 데이터 정렬로 지정하여 test 데이터베이스에 cafés 컬렉션을 만듭니다.

   db.getSiblingDB("test").createCollection( "cafés", { collation: { locale: "fr" } } );

2. customer_id 필드를 초기 샤드 키로 사용하여 collection을 샤딩합니다. 컬렉션에는 기본 fr 데이터 정렬이 있고 simple 데이터 정렬은 없으므로 shardCollection 명령에는 collation: { locale: "simple" } 옵션이 포함되어야 합니다.

   db.adminCommand( {
      shardCollection: "test.cafés",
      key: { customer_id: 1 },
      collation: { locale: "simple" }
   } )

샤드 키를 customer_id 필드와 order_id 필드 { customer_id: 1, order_id: 1 } 모두로 수정하려면 다음을 수행합니다.

1. 인덱스가 아직 존재하지 않는 경우 Create the index 를 사용하여 새 샤드 키를 지원합니다. 컬렉션에서 비단순 데이터 정렬을 사용하기 때문에 인덱스에 collation: { locale: "simple" } 옵션이 포함되어야 합니다.

   db.getSiblingDB("test").cafés.createIndex(
      { customer_id: 1, order_id: 1 },
      { collation: { locale: "simple" } }
   )

2. refineCollectionShardKey 명령을 실행하여 order_id 필드를 접미사로 추가합니다.

   db.adminCommand( {
      refineCollectionShardKey: "test.cafés",
      key: { customer_id: 1, order_id: 1 }
   } )

명령이 성공적으로 완료되면 collection의 샤드 키가 { customer_id: 1, order_id: 1 } 로 변경됩니다. sh.status() 을(를) 실행하여 확인할 수 있습니다.