changeStreamOptions

정의

changeStreamOptions

버전 6.0에 추가.

mongod 및 mongos 모두에 사용할 수 있습니다.

변경 스트림 구성 옵션이 포함된 객체입니다.

mongos 또는 복제본 세트 프라이머리에서만 changeStreamOptions 를 설정할 수 있습니다. 이 값은 cluster 전체에 걸쳐 설정됩니다.

구문

배포서버에 changeStreamOptions 를 설정하려면 admin 데이터베이스에서 다음 명령을 실행합니다.

db.adminCommand( { setClusterParameter: { changeStreamOptions: <value> } } )

changeStreamOptions 클러스터 매개변수의 현재 값을 보려면 admin 데이터베이스에서 다음 명령을 실행합니다.

db.adminCommand( { getClusterParameter: "changeStreamOptions" } )

매개변수 필드

changeStreamOptions.preAndPostImages.expireAfterSeconds

버전 6.0에 추가.

Default(기본값): OFF(꺼짐)

change stream 사전 및 사후 이미지의 보존 정책을 제어합니다. 사전 및 사후 이미지는 각각 문서 수정 전과 후의 문서 버전입니다. expireAfterSeconds 은(는) MongoDB가 사전 및 사후 이미지를 보관하는 기간을 제어합니다.

expireAfterSeconds 가 off면 MongoDB는 기본 보존 정책을 사용합니다. 즉, 해당 변경 스트림 이벤트가 oplog에서 제거될 때까지 사전 및 사후 이미지가 보존됩니다.

이미지 전후의 최소 보존 시간을 설정하려면 expireAfterSeconds 에 정수 값을 지정하세요.

중요

Triggers 및 Device Sync 등 변경 스트림을 사용하는 서비스는 사전 이미지 데이터의 가용성에 의존할 수 있습니다. expireAfterSeconds 를 너무 낮게 설정하다 하면 동기화 를 중단하거나 처리 를 트리거할 위험이 증가할 수 있습니다.

사전 이미지에 expireAfterSeconds 를 설정할 때 다음을 확인하세요.

• 서비스의 일반적인 변경 스트림 지연보다 낮지 않은 값을 지정합니다.

• 버퍼 시간을 추가하여 oplog 데이터 손실 위험을 감수하기 전에 서비스가 수동으로 재개될 수 있도록 합니다.

행동

변경 스트림 이벤트가 oplog에서 제거되면 changeStreamOptions.preAndPostImages.expireAfterSeconds 으)로 지정된 보존 시간에 관계없이 해당 사전 및 사후 이미지도 삭제됩니다.

예시

다음 예에서는 change stream에서 사전 및 사후 이미지의 보존 시간을 100 초로 설정합니다.

db.runCommand( {
   setClusterParameter: {
      changeStreamOptions: { preAndPostImages: { expireAfterSeconds: 100 } }
   }
} )