변경 스트림 이벤트

변경 스트림은 컬렉션, 데이터베이스 또는 배포에서 변경 사항이 있는지 감시합니다.

감시되는 리소스에 변경 사항이 발생하면 변경 스트림은 변경 이벤트 알림 문서와 함께 작업 및 변경 사항에 대한 정보를 반환합니다.

작업 유형

이벤트	설명
`create`	컬렉션을 만들 때 발생합니다. showExpandedEvents 옵션을 `true`로 설정해야 합니다. 버전 6.0에 추가 되었습니다.:
`createIndexes`	컬렉션에서 인덱스를 만들 때 발생 showExpandedEvents 옵션을 `true`로 설정해야 합니다. 버전 6.0에 추가 되었습니다.:
`delete`	문서가 컬렉션에서 제거될 때 발생
`drop`	컬렉션이 데이터베이스에서 제거될 때 발생합니다.
`dropDatabase`	데이터베이스가 제거될 때 발생합니다.
`dropIndexes`	컬렉션에서 인덱스가 제거될 때 발생 showExpandedEvents 옵션을 `true`로 설정해야 합니다. 버전 6.0에 추가 되었습니다.:
`insert`	작업이 컬렉션에 문서를 추가할 때 발생
`invalidate`	작업 렌더링으로 인해 변경 스트림이 유효하지 않을 때 발생
`modify`	컬렉션이 수정될 때 발생합니다. showExpandedEvents 옵션을 `true`로 설정해야 합니다. 버전 6.0에 추가 되었습니다.:
`refineCollectionShardKey`	샤드 키가 수정될 때 발생 버전 6.1에 추가 되었습니다.:
`rename`	컬렉션의 이름이 변경될 때 발생합니다.
`replace`	업데이트 작업이 컬렉션에서 문서를 제거하고 새 문서로 바꿀 때 발생합니다.
`reshardCollection`	컬렉션 및 데이터 배포에 대한 샤드 키가 변경될 때 발생합니다. showExpandedEvents 옵션을 `true`로 설정해야 합니다. 버전 의 새로운 6.1기능( 에서도 사용 6.0.14 가능):
`shardCollection`	컬렉션이 샤드될 때 발생 showExpandedEvents 옵션을 `true`로 설정해야 합니다. 버전 6.0에 추가 되었습니다.:
`update`	작업이 컬렉션의 문서를 업데이트할 때 발생합니다.

참고

서버는 교체 작업의 표현이 더 간결할 때 업데이트 작업을 교체 작업으로 반환할 수 있습니다. 업데이트 작업을 듣는다면, 교체 작업도 함께 듣습니다.

토큰 재개

각 변경 이벤트에는 변경 스트림 이벤트의 식별자 역할을 하는 BSON 객체인 _id 필드가 포함되어 있습니다. resumeToken까지 변경 스트림 재개하는 예시는 변경 스트림 재개를 참조하세요.

확장된 이벤트

버전 6.0에 추가 되었습니다.:

변경 스트림은 createIndexes 및 dropIndexes와 같은 DDL(데이터 정의 언어) 이벤트 알림을 지원합니다. 확장 이벤트를 포함하려면 showExpandedEvents 옵션을 사용하여 변경 스트림 커서를 엽니다.

예를 들면 다음과 같습니다.

let cur = db.names.watch( [ ], {
   showExpandedEvents: true
} )
cur.next()

let cur = db.names.aggregate( [ {
   $changeStream: {
       showExpandedEvents: true
     }
   }
 ] )
cur.next()

돌아가기

프로덕션 권장 사항

create