Docs Menu
Docs Home
/
MongoDB 매뉴얼
/
변경 스트림
/
이벤트 변경

reshardCollection 이벤트

이 페이지의 내용

  • 요약
  • 설명
  • 예제

요약

reshardCollection

버전6.1의 새로운 기능.: (버전 6.0.14로도 제공)

reshardCollection 이벤트는 다음과 같은 경우에 발생합니다.

  • 컬렉션 및 데이터 배포의 샤드 키가 변경되었습니다.

  • 변경 스트림에 showExpandedEvents 가 true 으)로 설정되어 있습니다.

설명

필드
유형
설명
_id
문서

변경 스트림 이벤트의 식별자 역할을 하는 BSON 객체입니다. 이 값은 변경 스트림을 재개할 때 resumeAfter 매개변수의 resumeToken(으)로 사용됩니다. _id 개체의 형식은 다음과 같습니다.

{
   "_data" : <BinData|hex string>
}

_data 유형은 MongoDB 버전 및 경우에 따라 변경 스트림 열기 또는 재개 시점의 기능 호환성 버전(FCV) 에 따라 달라집니다. _data 유형의 전체 목록은 재개 토큰 을 참조하세요.

resumeToken 기준으로 변경 스트림을 재개하는 예제는 변경 스트림 재개를 참조하세요.

clusterTime
타임스탬프

이벤트와 연결된 oplog 항목의 타임스탬프입니다.

다중 문서 트랜잭션과 연결된 변경 스트림 이벤트 알림은 모두 동일한 clusterTime 값(트랜잭션이 커밋된 시간)을 가집니다.

동일한 clusterTime 이벤트가 모두 동일한 트랜잭션 과 관련되지 않을 수 있습니다. 일부 이벤트는 트랜잭션 과 전혀 관련이 없습니다. MongoDB 8.0 부터 모든 배포서버 서버의 이벤트에 해당될 수 있습니다. 이전 버전에서는 이 동작이 샤딩된 클러스터 의 이벤트에 대해서만 가능했습니다.

단일 트랜잭션에 대한 이벤트를 식별하려면 변경 스트림 이벤트 문서에서 lsid 및 txnNumber 조합을 사용할 수 있습니다.

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

collectionUUID
UUID

변경이 발생한 컬렉션을 식별하는 UUID입니다.

버전 6.0에 추가.

ns
문서

이벤트의 영향을 받는 네임스페이스(데이터베이스 및/또는 컬렉션)입니다.

ns.coll
문자열

이벤트가 발생한 컬렉션의 이름입니다.

ns.db
문자열

이벤트가 발생한 데이터베이스의 이름입니다.

operationDescription
문서

변경 작업에 대한 추가 정보입니다.

이 문서와 해당 하위 필드는 변경 스트림이 확장 이벤트를 사용하는 경우에만 표시됩니다.

버전 6.0에 추가.

operationDescription.
reshardUUID
UUID

리샤딩 작업을 식별하는 UUID 입니다.

버전 6.1에 추가.

operationDescription. | shardKey
문서

변경이 발생한 collection의 샤드 키 입니다.

버전 6.0에 추가.

operationDescription. | oldShardKey
문서

변경된 collection의 샤드 키 입니다.

버전 6.1에 추가.

operationDescription. | unique
부울

collection이 고유한 샤드 키로 샤딩된 경우 값은 true입니다.

버전 6.0에 추가.

operationDescription. | numInitialChunks
NumberLong

shardCollection 작업 중에 각 샤드에 생성된 청크의 수입니다.

버전 6.0에 추가.

operationDescription.
collation
문서

샤드 키 인덱스에 사용되는 데이터 정렬 문서입니다.

버전 6.1에 추가.

operationDescription.
zones
배열

새 샤드 키에 추가된 구역입니다.

버전 6.1에 추가.

예제

다음 예시는 reshardCollection 이벤트를 보여줍니다.

{
   "_id": { <ResumeToken> },
   "operationType": "reshardCollection",
   "collectionUUID": 0,
   "ns": {"db": "reshard_collection_event", "coll": "coll"},
   "operationDescription": {
     "reshardUUID": 0,
     "shardKey": {"newKey": 1},
     "oldShardKey": {"_id": 1},
     "unique": false,
     "numInitialChunks": NumberLong(1),
     "collation": {"locale": "simple"},
     "zones": [
         {"zone": "zone1", "min": {"newKey": {"$minKey": 1}}, "max": {"newKey": {"$maxKey": 1}}}
     ]
   }
}

돌아가기

갈다

이 페이지의 내용