무효화

이 페이지의 내용

요약

invalidate: 작업으로 인해 변경 스트림이 유효하지 않게 렌더링되면 invalidate 이벤트가 발생합니다. 예를 들어 나중에 삭제되거나 이름이 변경된 컬렉션에서 변경 스트림을 열면 invalidate 이벤트가 발생합니다.

필드

유형

설명

_id

문서

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

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

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

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

clusterTime

타임스탬프

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

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

샤딩된 클러스터에서는 동일한 clusterTime 이벤트가 모두 동일한 트랜잭션과 관련되지 않을 수 있습니다. 일부 이벤트는 트랜잭션과는 전혀 관련이 없습니다.

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

버전 4.0에 추가.

operationType

문자열

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

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

다음 예시는 invalidate 이벤트에 대한 설명입니다.

{
   "_id": { <Resume Token> },
   "operationType": "invalidate",
   "clusterTime": <Timestamp>,
}

컬렉션에서 열린 변경 스트림은 감시 대상 컬렉션에 영향을 미치는 drop, rename 또는 dropDatabase 작업이 발생할 때 invalidate 이벤트를 발생시킵니다.

데이터베이스에서 열린 변경 스트림은 감시 대상 데이터베이스에 영향을 미치는 dropDatabase 이벤트가 발생할 때 invalidate 이벤트를 발생시킵니다.

invalidate 이벤트는 변경 스트림 커서를 닫습니다.

resumeAfter 무효화 이벤트 (예: 컬렉션 삭제 또는 이름 변경)로 인해 스트림이 닫힌 4 후에는 를2 사용하여 변경 스트림을 재개할 수 없습니다. MongoDB 부터 시작됩니다. 무효화 이벤트 후 startAfter 를 사용하여 새 변경 스트림을 시작할 수 있습니다.