`modify` 이벤트

이 페이지의 내용

요약

설명
예시

요약

modify: 버전 6.0에 추가.
modify 이벤트 는 collMod 명령이 컬렉션 이나 뷰에 옵션을 추가하거나 제거 할 때와 같이 컬렉션 이 수정될 때 발생합니다. 이 이벤트 는 변경 스트림 에 showExpandedEvents 옵션이 true 로 설정하다 경우에만 수신됩니다.
참고
명확화
개별 문서가 업데이트될 때 발생하는 이벤트에 대해 자세히 알아보려면 update 이벤트를 참조하세요.

설명

필드

유형

설명

_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

컬렉션 에서 변경 사항이 발생한 경우 collectionUUID 은 컬렉션의 UUID 를 나타냅니다. 뷰에서 변경 사항이 발생한 경우 collectionUUID 는 존재하지 않습니다.

버전 6.0에 추가.

lsid

문서

트랜잭션과 연결된 세션의 식별자입니다.

작업이 다중 문서 트랜잭션의 일부인 경우에만 표시됩니다.

ns

문서

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

ns.db

문자열

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

ns.coll

문자열

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

operationDescription

문서

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

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

버전 6.0에 추가.

operationDescription.

index

문서

수정된 인덱스입니다.

버전 6.0에 추가.

operationDescription.

indexes

배열

이 작업으로 변경된 인덱스가 나열된 문서 배열입니다.

operationType

문자열

변경 알림이 보고하는 작업 유형입니다.

이러한 변경 이벤트에 대해 modify 값을 반환합니다.

stateBeforeChange

문서

문서는 작업으로 변경되기 전의 컬렉션과 인덱스 옵션을 보여 줍니다.

stateBeforeChange.

collectionOptions

문서

문서에는 작업으로 인해 변경되기 전의 컬렉션 옵션이 표시됩니다.

stateBeforeChange.

indexOptions

문서

문서는 작업으로 변경되기 전의 인덱스 옵션을 보여 줍니다.

txnNumber

NumberLong

lsid와 함께 트랜잭션을 고유하게 식별하는 데 도움이 되는 번호입니다.

작업이 다중 문서 트랜잭션의 일부인 경우에만 표시됩니다.

wallTime

ISODate

데이터베이스 작업의 서버 날짜 및 시간입니다. wallTime은(는) clusterTime이(가) 데이터베이스 작업 이벤트와 관련된 oplog 항목에서 가져온 타임스탬프라는 점에서 clusterTime와(과) 다릅니다.

버전 6.0에 추가.

예시

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

{
   "_id": { <ResumeToken> },
   "operationType": "modify",
   "clusterTime": Timestamp({ t: 1654878543, i: 1 }),
   "collectionUUID": UUID("47d6baac-eeaa-488b-98ae-893f3abaaf25"),
   "wallTime": ISODate("2022-06-10T16:29:03.704Z"),
   "ns": {
      "db": "test",
      "coll": "authors" },
   "operationDescription": {
      "index": {
         "name": "age_1",
         "hidden": true
      }
   },
   "stateBeforeChange": {
      "collectionOptions": {
          "uuid": UUID("47d6baac-eeaa-488b-98ae-893f3abaaf25")
      },
      "indexOptions": {
         "hidden": false
      }
   }
}

돌아가기

invalidate

refineCollectionShardKey

요약

참고

명확화

설명

예시