update 이벤트

이미지 사전 및 사후 문서화

MongoDB 6.0부터 다음 단계를 수행하면 문서가 변경(또는 삭제) 되기 전의 필드가 포함된 fullDocumentBeforeChange 문서가 표시됩니다.

1. db.createCollection(), create, 또는 collMod을(를) 사용하는 컬렉션에 대해 새 changeStreamPreAndPostImages 필드를 사용하도록 설정합니다.

2. fullDocumentBeforeChange을(를) "required" 또는 db.collection.watch() 에서 "whenAvailable"(으)로 설정합니다.

변경 스트림 출력의 예제 fullDocumentBeforeChange 문서입니다.

"fullDocumentBeforeChange" : {
   "_id" : ObjectId("599af247bb69cd89961c986d"),
   "userName" : "alice123",
   "name" : "Alice Smith"
}

변경 스트림 출력에 대한 전체 예시는 전후 이미지를 포함하는 문서의 Change Streams를 참조하세요.

이미지가 다음과 같은 경우 change stream 이벤트에 사전 및 사후 이미지를 사용할 수 없습니다.

• 문서 업데이트 또는 삭제 작업 시 collection에서 활성화되지 않았습니다.

• expireAfterSeconds에서 전후 이미지 보존 시간 설정 이후에 제거됩니다.

  • 다음 예에서는 전체 cluster에서 expireAfterSeconds 을 100 초로 설정합니다.

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

  • 다음 예에서는 특정 collection에서 expireAfterSeconds ~ 100 초를 설정합니다.

    use admin
    db.getSiblingDB("my_collection")
      .sensors.watch({ changeStreamOptions:
        { preAndPostImages: { expireAfterSeconds: 100 } } })

  • 다음 예제에서는 expireAfterSeconds 등 현재 changeStreamOptions 설정을 반환합니다.

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

  • expireAfterSeconds를 off로 설정하면 기본 보존 정책이 사용되며, 해당 change stream 이벤트가 oplog에서 제거될 때까지 사전 및 사후 이미지가 보존됩니다.

  • change stream 이벤트가 oplog에서 제거되면 expireAfterSeconds 사전 및 사후 이미지 보존 시간에 관계없이 해당 사전 및 사후 이미지도 삭제됩니다.

추가 고려 사항

• 전후 이미지를 활성화하면 저장 공간이 소모되고 처리 시간이 늘어납니다. 필요한 경우에만 전후 이미지를 활성화하세요.

• 변경 스트림 이벤트 크기를 16메가바이트 미만으로 제한합니다. 이벤트 크기를 제한하려면 다음을 수행하면 됩니다.

  • 문서 크기를 8메가바이트로 제한합니다. updateDescription과 같은 다른 change stream 이벤트 필드가 크지 않은 경우 change stream 출력에서 사전 및 사후 이미지를 동시에 요청할 수 있습니다.

  • updateDescription과 같은 다른 change stream 이벤트 필드가 크지 않은 경우 최대 16메가바이트 문서에 대해 change stream 출력에서 사후 이미지만 요청합니다.

  • 다음과 같은 경우 최대 16메가바이트의 문서에 대해 change stream 출력에서 사전 이미지만 요청합니다.

    • 문서 업데이트가 문서 구조나 내용의 작은 부분에만 영향을 미칩니다. 그리고

    • replace 변경 이벤트를 발생시키지 않습니다. replace 이벤트에는 항상 후이미지가 포함됩니다.

• 사전 이미지를 요청하려면 db.collection.watch()에서 fullDocumentBeforeChange를 required 또는 whenAvailable로 설정합니다. 사후 이미지를 요청하려면 동일한 방법으로 fullDocument를 설정합니다.

• 사전 이미지가 config.system.preimages 컬렉션에 기록됩니다.

  • config.system.preimages collection은 커질 수 있습니다. collection 크기를 제한하려면 앞서 표시된 대로 사전 이미지에 대해 expireAfterSeconds 시간을 설정할 수 있습니다.

  • 사전 이미지는 백그라운드 프로세스가 비동기적으로 제거합니다.

경로 혼동

updateDescription 필드는 작업으로 인해 문서의 특정 필드에 변경된 내용을 기록합니다. 이러한 필드 설명자는 점(.)을 경로 구분자로 사용하고 숫자를 배열 인덱스로 사용하므로 점이나 숫자를 사용하는 필드 이름이 포함된 경우 모호성이 발생합니다.

update 이벤트가 모호한 disambiguatedPaths 필드와 관련된 변경 사항을 보고하면 문서에서 경로 키에 각 경로 구성 요소를 나열하는 배열을 제공합니다.

예를 들어, 사람과 그들이 살고 있는 마을을 나열하는 문서를 고려해 보겠습니다.

{
   "name": "Anthony Trollope",
   "home.town": "Oxford",
   "residences": [
      {"0": "Oxford"},
      {"1": "Sunbury"}
   ]
}

• 업데이트에서 home.town 필드를 Oxford에서 London(으)로 수정하면 다음과 같은 업데이트 설명이 생성됩니다.

  "updateDescription": {
     "updatedFields": {
        "home.town": "London"
     },
     "disambiguatedPaths": {
        "home.town": [ "home.town" ]
     }
  }

  home.town 필드에 마침표가 포함되어 있으므로 disambiguatedPaths 필드에는 하나의 값이 있는 배열이 표시되어 town(이)가 home의 하위 필드가 아님을 나타냅니다.

• 업데이트가 동일한 변경을 위해 residences 배열의 값을 수정하면 다음과 같은 업데이트 설명이 생성됩니다.

  "updateDescription": {
     "updatedFields": {
        "residences.0.0": "London"
     },
     "disambiguatedPaths": { "residences.0.0": [ "residences", 0, "0" ] }
  }

  명확해진 경로에는 배열 인덱스를 나타내는 정수 0 및 중첩된 문서 내의 필드 이름을 나타내는 문자열 "0"(이)가 포함됩니다.

disambiguatedPath 에 숫자 필드가 포함되지 않는 두 가지 경우가 있습니다.

• 경로의 첫 번째 필드가 숫자 문자열인 경우(즉, 0.name). 첫 번째 필드는 배열 인덱스가 될 수 없으므로 이는 모호하지 않습니다.

• 숫자 문자열 필드에 선행 0이 있는 경우(예: 0001). 정수는 앞에 0을 가질 수 없으므로 이는 모호하지 않습니다.