Docs Menu
Docs Home
/
MongoDB 매뉴얼
/ /

refineCollectionShardKey 이벤트

이 페이지의 내용

  • 요약
  • 설명
  • 예시
refineCollectionShardKey

버전 6.0에 추가.

컬렉션의 샤드 키가 수정되면 refineCollectionShardKey 이벤트가 발생합니다.

필드
유형
설명

_id

문서

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

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

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

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

clusterTime

타임스탬프

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

oplog 크기 제한으로 인해다중 문서 트랜잭션은 여러 oplog 항목을 생성할 수 있습니다. 트랜잭션 에서 지정된 oplog 항목에 스테이징된 변경 스트림 이벤트는 동일한 clusterTime 를 주식 합니다.

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

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

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

collectionUUID

UUID

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

버전 6.0에 추가.

ns

문서

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

ns.coll

문자열

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

ns.db

문자열

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

operationDescription

문서

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

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

버전 6.0에 추가.

operationDescription.
shardKey

문서

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

버전 6.0에 추가.

operationDescription.
oldShardKey

문서

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

버전 6.1에 추가.

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

{
"_id": { <ResumeToken> },
"operationType": "refineCollectionShardKey",
"clusterTime": Timestamp({ t: 1654894852, i: 52 }),
"collectionUUID": UUID("98046a1a-b649-4e5b-9c75-67594221ce19"),
"ns": {"db": "reshard_collection_event", "coll": "coll"},
"operationDescription": {
"shardKey": {"_id": 1, akey: 1},
"oldShardKey": {"_id": 1}
}
}

돌아가기

modify

이 페이지의 내용