Azure Cosmos DB의 변경 피드 모드

최신 버전 모드는 컨테이너의 시작 부분에서 변경 내용으로 돌아갈 수 있는 기능을 통해 컨테이너의 항목에 대한 실시간 변경 내용과 기록 변경 내용을 쉽게 처리할 수 있는 방법을 제공합니다.

다음은 이 모드에 적합한 시나리오입니다.

• 전체 컨테이너를 보조 위치로 마이그레이션

• 컨테이너의 시작 부분에서 변경 내용을 다시 처리하는 기능

• 만들기 및 업데이트 작업으로 인한 컨테이너 내 항목의 변경 내용을 실시간으로 처리

• 삭제 또는 읽기 사이의 중간 변경 내용을 캡처할 필요가 없는 워크로드

모든 버전 및 삭제 변경 피드 모드는 변경 피드에 대한 새 시나리오를 지원하고 기타 시나리오를 간소화합니다. 항목에 발생한 모든 변경 내용을 읽고(변경 피드 읽기 간에 여러 변경이 발생한 경우에도), 처리 중인 변경의 작업 유형을 식별하고, 삭제로 인한 변경 내용을 가져올 수 있습니다.

이 모드가 지원하고 향상하는 일반적인 시나리오는 다음과 같습니다.

• 일시 삭제를 구현하지 않고 두 위치 간에 데이터를 실시간으로 전송

• 변경 피드 폴링 간에 지정된 항목에 대한 여러 변경 작업이 예상되는 경우 증분 변경을 기반으로 논리를 트리거

• 감사 시나리오와 같이 삭제 작업에 대한 경고를 트리거

• 작업 유형에 따라 항목을 다르게 만들고, 업데이트하고, 삭제하는 기능

• 변경 피드는 컨테이너 내의 항목에 수행된 삽입 및 업데이트 작업을 포함합니다.

• 이 변경 피드 모드는 삭제를 기록하지 않습니다. 항목을 직접 삭제하는 대신 항목 내에서 "일시 삭제" 플래그를 설정하여 삭제를 캡처할 수 있습니다. 예를 들어 deleted라는 항목에서 특성을 추가하고 해당 값을 true로 설정한 다음, 항목의 TTL(Time-to-Live)을 설정할 수 있습니다. 변경 피드는 이를 업데이트로 캡처하며, TTL이 만료되면 항목이 자동으로 삭제됩니다. 또는 TTL 기능을 사용하여 항목의 제한된 만료 기간을 설정할 수 있습니다. 이 솔루션을 사용하여 TTL 만료 기간보다 짧은 시간 간격 내에 변경 내용을 처리해야 합니다.

• 특정 항목의 가장 최근 변경 내용만 변경 피드에 포함됩니다. 중간 변경 사항을 확인할 수 없습니다.

• 항목이 삭제되면 해당 항목은 더 이상 변경 피드에서 사용할 수 없습니다.

• 특정 시점에 변경 내용을 동기화할 수 있으며, 변경 내용을 사용할 수 있는 고정된 데이터 보존 기간은 없습니다.

• 특정 작업 유형에 대한 변경 피드를 필터링할 수 없습니다. 사용 가능한 한 가지 대안은 업데이트에 대한 항목에 "소프트 표식"을 추가하고, 변경 피드에서 항목을 처리할 때 마커를 기반으로 필터링하는 것입니다.

• 변경 피드를 읽는 시작점은 컨테이너의 시작 부분, 특정 시점, "지금"부터 또는 특정 검사점입니다. 시작 시간의 정밀도는 약 5초입니다.

• 변경 피드는 컨테이너 안에 있는 항목에 수행된 삽입, 업데이트 및 삭제 작업을 포함합니다. TTL 만료로 인한 삭제도 캡처됩니다.

• TTL 만료로 인한 삭제 여부를 포함하여 변경 유형을 확인하기 위한 메타데이터가 제공됩니다.

• 변경 피드 항목은 수정 시간 순서대로 도착합니다. 트랜잭션 일괄 처리, 저장 프로시저 또는 대량 모드 요청의 범위에서 작성된 항목은 수정 시간이 동일하며 해당 범위 내의 변경 내용은 순서에 따라 배달될 수 있습니다. TTL 만료로 인한 삭제는 항목이 만료되는 즉시 피드에 표시된다는 보장이 없습니다. 항목이 컨테이너에서 제거될 때 그것들이 나타납니다.

• 계정의 연속 백업에 대한 보존 기간 내에서 발생한 모든 변경 내용을 읽을 수 있습니다. 보존 기간 이후에 발생한 변경 내용을 읽으려고 시도하면 오류가 발생합니다. 예를 들어 컨테이너가 8일 전에 만들어졌고 지속적인 백업 보존 기간이 7일이면 최근 7일의 변경 내용만 읽을 수 있습니다.

• 변경 피드 시작점은 "지금"부터 또는 보존 기간 내의 특정 검사점입니다. 이 모드를 사용하면 컨테이너의 시작 부분이나 특정 시점부터 변경 내용을 읽는 것이 불가능합니다.

다음과 같은 방법으로 최신 버전 모드에서 변경 피드의 변경 내용을 사용할 수 있습니다.

응답 개체 구문 분석

최신 버전 모드에서 기본 응답 개체는 변경된 항목의 배열입니다. 각 항목에는 _etag 및 _ts를 비롯한 Azure Cosmos DB 항목의 표준 메타데이터가 포함되어 있으며, 새 속성 _lsn이 추가됩니다.

_etag 형식은 내부용이며 언제든지 변경될 수 있으므로 이 형식에 종속되면 안 됩니다. _ts는 수정 또는 생성 타임스탬프입니다. 시간순 비교를 위해 _ts를 사용할 수 있습니다. _lsn은 변경 피드에 대해서만 추가되는 일괄 처리 ID로, 트랜잭션 ID를 나타냅니다. 여러 항목이 동일한 _lsn을 가질 수 있습니다.

ETag의 FeedResponse는 항목에 표시되는 _etag와 다릅니다. _etag는 내부 식별자이며, 동시성 제어에 사용됩니다. _etag 속성은 항목 버전을 나타내고, ETag 속성은 피드를 시퀀싱하는 데 사용됩니다.

미리 보기 기간에는 변경 피드를 읽는 다음 방법을 각 클라이언트 SDK에 사용할 수 있습니다.

시작하기

모든 버전 사용을 시작하고 변경 피드 모드를 삭제하려면 Azure Cosmos DB 계정의 기능 페이지로 이동합니다. 모든 버전을 선택하고 모든 버전 및 삭제 변경 피드 모드(미리 보기) 기능을 활성화합니다. 기능을 사용하도록 설정하기 전에 Azure Cosmos DB 계정에 대해 연속 백업 을 구성해야 합니다. 사용 프로세스를 완료하는 데 최대 30분이 걸릴 수 있으며 이 시간 동안 계정에 다른 변경 내용을 적용할 수 없습니다.

또는 REST API를 사용하여 계정의 "enableAllVersionsAndDeletesChangeFeed" : true에 properties을 추가함으로써 기존 계정에서 모든 버전 및 삭제 모드를 활성화할 수 있습니다. 이 속성은 미리 보기 API 버전 2024-12-01-preview 이상에서 사용할 수 있습니다. 계정을 만드는 동안 이 기능을 사용하도록 설정하는 것은 지원되지 않습니다.

응답 개체 구문 분석

응답 개체는 각 변경을 나타내는 항목의 배열입니다. 변경 유형에 따라 다른 속성이 채워집니다. 현재 바꾸기 또는 삭제 작업에 대한 이전 버전의 항목을 가져올 수 있는 방법은 없습니다.

• 작업 만들기

  {
    "current": {
      <The current version of the item that changed. All the properties of your item will appear here.>
    },
    "metadata": {
      "operationType": "create",
      "lsn": <A number that represents the batch ID. Many items can have the same lsn.>,
      "crts": <A number that represents the Conflict Resolved Timestamp. It has the same format as _ts.>
    }
  }
  

• 작업 바꾸기

  {
    "current": {
      <The current version of the item that changed. All the properties of your item will appear here.>
    },
    "metadata": {
      "operationType": "replace",
      "lsn": <A number that represents the batch ID. Many items can have the same lsn.>,
      "crts": <A number that represents the Conflict Resolved Timestamp. It has the same format as _ts.>,
      "previousImageLSN" : <A number that represents the batch ID of the change prior to this one.>,
    }
  }
  

• 삭제 작업

  {
    "metadata": {
      "operationType": "delete",
      "lsn": <A number that represents the batch ID. Many items can have the same lsn.>,
      "crts": <A number that represents the Conflict Resolved Timestamp. It has the same format as _ts.>,
      "previousImageLSN" : <A number that represents the batch ID of the change prior to this one.>,
      "timeToLiveExpired" : <'true' if it was deleted due to a TTL expiration.>,
      "id": "<Id of the deleted item.>",
      "partitionKey": {
        "<Partition key property name>": "<Partition key property value>"
      }
    }
  }
  

제한점

• Azure Cosmos DB for NoSQL 계정을 지원합니다. 다른 Azure Cosmos DB 계정 유형은 지원되지 않습니다.

• 이 변경 피드 모드를 사용하려면 지속적인 백업이 필요합니다. 연속 백업 사용의 제한 사항을 참조하세요.

• 변경 피드를 처음부터 읽거나 과거 타임스탬프를 기반으로 시작 시간을 선택하는 기능은 현재 지원되지 않습니다. "지금"부터 시작하거나 이전 임대 또는 연속 토큰부터 시작할 수 있습니다.

• 삭제되거나 업데이트된 이전 버전의 항목을 현재 받을 수 없습니다.

• 파티션 병합을 사용하도록 설정한 계정은 지원되지 않습니다.