Tryby zestawienia zmian w usłudze Azure Cosmos DB

DOTYCZY: NoSQL

Usługa Azure Cosmos DB oferuje dwa tryby zestawienia zmian. Każdy tryb oferuje te same podstawowe funkcje. Różnice obejmują operacje przechwycone w kanale informacyjnym, metadane dostępne dla każdej zmiany oraz okres przechowywania zmian. Zestawienie zmian można używać w różnych trybach dla wielu aplikacji dla tego samego kontenera usługi Azure Cosmos DB, aby dopasować je do wymagań poszczególnych obciążeń. Każdą pojedynczą aplikację zestawienia zmian można skonfigurować tylko do odczytu zestawienia zmian w jednym trybie. Korzystanie ze zestawienia zmian w jednym trybie nie uniemożliwia korzystania ze zestawienia zmian w innym trybie w innej aplikacji.

Uwaga

Czy masz jakieś opinie na temat trybów zestawienia zmian? Chcemy to usłyszeć! Możesz podzielić się opiniami bezpośrednio z zespołem inżynierów usługi Azure Cosmos DB: cosmoschangefeed@microsoft.com.

Tryb zestawienia zmian najnowszej wersji

Tryb najnowszej wersji to trwały rekord zmian wprowadzonych w elementach z tworzenia i aktualizacji. Uzyskasz najnowszą wersję każdego elementu w kontenerze. Jeśli na przykład element zostanie utworzony, a następnie zaktualizowany przed przeczytaniem zestawienia zmian, tylko zaktualizowana wersja pojawi się w kanale informacyjnym zmian. Usunięcia nie są przechwytywane jako zmiany, a usunięcie elementu nie jest już dostępne w kanale informacyjnym. Najnowszy tryb zestawienia zmian wersji jest domyślnie włączony i jest zgodny ze wszystkimi kontami usługi Azure Cosmos DB, z wyjątkiem interfejsu API dla tabel i interfejsu API dla postgreSQL. Ten tryb był wcześniej domyślnym sposobem korzystania z zestawienia zmian.

Wszystkie wersje i usuwa tryb zestawienia zmian (wersja zapoznawcza)

Wszystkie wersje i tryb usuwania (wersja zapoznawcza) to trwały rekord wszystkich zmian elementów z operacji tworzenia, aktualizowania i usuwania. Każdy rekord każdej zmiany elementów zostanie wyświetlony w kolejności, w której wystąpił, w tym pośrednie zmiany w elemencie między odczytami zestawienia zmian. Jeśli na przykład element zostanie utworzony, a następnie zaktualizowany przed przeczytaniem zestawienia zmian, zarówno tworzenie, jak i wersje aktualizacji elementu są wyświetlane w kanale informacyjnym zmian. Aby odczytywać ze zestawienia zmian we wszystkich wersjach i usuwać tryb, musisz mieć stałe kopie zapasowe skonfigurowane dla konta usługi Azure Cosmos DB. Włączenie ciągłych kopii zapasowych powoduje utworzenie wszystkich wersji i usunięcie zestawienia zmian. Zmiany, które wystąpiły w okresie ciągłej kopii zapasowej, można odczytywać tylko w przypadku korzystania z tego trybu zestawienia zmian. Ten tryb jest zgodny tylko z kontami usługi Azure Cosmos DB for NoSQL. Dowiedz się więcej o tym, jak zarejestrować się w celu uzyskania wersji zapoznawczej.

Przypadki użycia zestawienia zmian

Tryb najnowszej wersji

Tryb najnowszej wersji umożliwia łatwe przetwarzanie zarówno zmian w czasie rzeczywistym, jak i historycznych elementów w kontenerze z możliwością powrotu do zmian od początku kontenera.

Poniżej przedstawiono scenariusze odpowiednie dla tego trybu:

• Migracje całego kontenera do lokalizacji pomocniczej.

• Możliwość ponownego przetwarzania zmian od początku kontenera.

• Przetwarzanie w czasie rzeczywistym zmian w elementach w kontenerze wynikających z operacji tworzenia i aktualizowania.

• Obciążenia, które nie muszą przechwytywać operacji usuwania ani pośrednich zmian między operacjami odczytu.

Wszystkie wersje i tryb usuwania (wersja zapoznawcza)

Wszystkie wersje i usuwanie trybu zestawienia zmian umożliwiają korzystanie z nowych scenariuszy kanału informacyjnego zmian i upraszcza inne. Można odczytać każdą zmianę, która wystąpiła w elementach (nawet w przypadkach, w których wystąpiły wiele zmian między odczytami zestawienia zmian), zidentyfikować typ operacji przetwarzanych zmian i uzyskać zmiany wynikające z usunięcia.

Oto kilka typowych scenariuszy, w których ten tryb włącza i ulepsza:

• Transfer danych w czasie rzeczywistym między dwiema lokalizacjami bez implementowania usuwania nietrwałego.

• Wyzwalanie logiki na podstawie zmian przyrostowych, jeśli oczekuje się wielu operacji zmiany dla danego elementu między sondami zestawienia zmian.

• Wyzwalanie alertów dotyczących operacji usuwania, takich jak w scenariuszach inspekcji.

• Możliwość przetwarzania elementów tworzy, aktualizuje i usuwa inaczej na podstawie typu operacji.

Funkcje każdego trybu

Oprócz typowych funkcji we wszystkich trybach zestawienia zmian każdy tryb zestawienia zmian ma następujące cechy:

Tryb najnowszej wersji

• Zestawienie zmian obejmuje operacje wstawiania i aktualizowania, które są wprowadzane do elementów w kontenerze.

• Ten tryb zestawienia zmian nie powoduje usunięcia dziennika. Usunięcie można przechwycić, ustawiając flagę "usuwanie nietrwałe" w elementach zamiast usuwać je bezpośrednio. Możesz na przykład dodać atrybut w elemencie o nazwie deleted z wartością true, a następnie ustawić czas wygaśnięcia (TTL) w elemencie. Źródło zmian przechwytuje je jako aktualizację, a element zostanie automatycznie usunięty po wygaśnięciu czasu wygaśnięcia. Alternatywnie można ustawić skończony okres wygaśnięcia dla elementów przy użyciu funkcji TTL. Dzięki temu rozwiązaniu należy przetworzyć zmiany w krótszym przedziale czasu niż okres wygaśnięcia czasu wygaśnięcia.

• Tylko najnowsza zmiana dla określonego elementu jest uwzględniona w kanale informacyjnym zmian. Zmiany pośrednie mogą być niedostępne.

• Po usunięciu elementu nie jest już dostępny w kanale informacyjnym zmian.

• Zmiany można synchronizować z dowolnego punktu w czasie i nie ma stałego okresu przechowywania danych, dla którego są dostępne zmiany.

• Nie można filtrować zestawienia zmian dla określonego typu operacji. Jedną z możliwych alternatyw jest dodanie "znacznika miękkiego" dla elementu w celu aktualizacji i filtrowania na podstawie znacznika podczas przetwarzania elementów w kanale informacyjnym zmian.

• Punktem wyjścia do odczytu zestawienia zmian może być od początku kontenera, od punktu w czasie, od "teraz" lub z określonego punktu kontrolnego. Precyzja czasu rozpoczęcia wynosi około pięciu sekund.

Wszystkie wersje i tryb usuwania (wersja zapoznawcza)

• Źródło zmian obejmuje operacje wstawiania, aktualizowania i usuwania wykonywane do elementów w kontenerze. Usunięcia z wygasania czasu wygaśnięcia są również przechwytywane.

• Metadane są udostępniane w celu określenia typu zmiany, w tym tego, czy usunięcie zostało spowodowane wygaśnięciem czasu wygaśnięcia.

• Elementy zestawienia zmian są uporządkowane w czasie ich modyfikacji. Usunięcie z wygaśnięcia czasu wygaśnięcia nie ma gwarancji, że zostanie wyświetlone w kanale informacyjnym natychmiast po wygaśnięciu elementu. Są one wyświetlane, gdy element jest czyszczone z kontenera.

• Wszystkie zmiany, które wystąpiły w oknie przechowywania dla ciągłych kopii zapasowych na koncie, można odczytać. Próba odczytania zmian, które wystąpiły poza oknem przechowywania, powoduje wystąpienie błędu. Jeśli na przykład kontener został utworzony osiem dni temu, a okres przechowywania ciągłej kopii zapasowej wynosi siedem dni, możesz odczytywać tylko zmiany z ostatnich siedmiu dni.

• Punkt początkowy zestawienia zmian może pochodzić z "teraz" lub z określonego punktu kontrolnego w okresie przechowywania. Nie można odczytać zmian od początku kontenera ani z określonego punktu w czasie przy użyciu tego trybu.

Praca z zestawieniem zmian

Każdy tryb jest zgodny z różnymi metodami odczytywania zestawienia zmian dla każdego języka.

Tryb najnowszej wersji

Możesz użyć następujących sposobów, aby korzystać ze zmian ze zestawienia zmian w trybie najnowszej wersji:

Metoda odczytywania zestawienia zmian	.NET	Java	Python	Node.js
Model ściągania zestawienia zmian	Tak	Tak	Tak	Tak
Procesor zestawienia zmian	Tak	Tak	Nie.	Nie.
Wyzwalacz usługi Azure Functions	Tak	Tak	Tak	Tak

Analizowanie obiektu odpowiedzi

W trybie najnowszej wersji domyślny obiekt odpowiedzi to tablica elementów, które uległy zmianie. Każdy element zawiera standardowe metadane dla dowolnego elementu usługi Azure Cosmos DB, w tym _etag i _ts, z dodatkiem nowej właściwości _lsn.

Format _etag jest wewnętrzny i nie należy brać od niego zależności, ponieważ może się zmieniać w dowolnym momencie. _ts jest modyfikacją lub sygnaturą czasową tworzenia. Można użyć _ts do porównania chronologicznego. _lsn jest identyfikatorem wsadowym, który jest dodawany tylko dla zestawienia zmian, który reprezentuje identyfikator transakcji. Wiele elementów może mieć ten sam _lsnelement .

ETag element on FeedResponse różni się od _etag widocznego elementu . _etag jest identyfikatorem wewnętrznym i jest używany do sterowania współbieżnością. Właściwość _etag reprezentuje wersję elementu, natomiast ETag właściwość jest używana do sekwencjonowania kanału informacyjnego.

Wszystkie wersje i tryb usuwania (wersja zapoznawcza)

W wersji zapoznawczej dostępne są następujące metody odczytu zestawienia zmian dla każdego zestawu SDK klienta:

Metoda odczytywania zestawienia zmian	.NET	Java	Python	Node.js
Model ściągania zestawienia zmian	>= 3.32.0-preview	>= 4.42.0	Nie.	>= 4.1.0
Procesor zestawienia zmian	>= 3.40.0-preview.0	>= 4.42.0	Nie	Nie.
Wyzwalacz usługi Azure Functions	Nie	Nie.	Nie.	Nr

Uwaga

Niezależnie od trybu połączenia skonfigurowanego w aplikacji wszystkie żądania wysyłane ze wszystkimi wersjami i usuwania zestawienia zmian będą używać trybu bramy.

Rozpocznij

Aby rozpocząć korzystanie ze wszystkich wersji i usuwać tryb zestawienia zmian, zarejestruj się w wersji zapoznawczej za pośrednictwem strony Funkcje w wersji zapoznawczej na stronie przeglądu subskrypcji platformy Azure. Wyszukaj funkcję AllVersionsAndDeletesChangeFeed i wybierz pozycję Zarejestruj.

Przed przesłaniem żądania upewnij się, że masz co najmniej jedno konto usługi Azure Cosmos DB w subskrypcji. To konto może być istniejącym kontem lub nowym kontem utworzonym w celu wypróbowania funkcji w wersji zapoznawczej. Jeśli nie masz kont w subskrypcji po odebraniu żądania, żądanie zostanie odrzucone, ponieważ nie ma kont do zastosowania tej funkcji.

Zespół usługi Azure Cosmos DB przegląda twoje żądanie i kontaktuje się za pośrednictwem poczty e-mail, aby potwierdzić, które konta usługi Azure Cosmos DB w subskrypcji, którą chcesz zarejestrować w wersji zapoznawczej. Aby korzystać z wersji zapoznawczej, musisz mieć stałe kopie zapasowe skonfigurowane dla konta usługi Azure Cosmos DB. Ciągłe kopie zapasowe można włączyć przed lub po przyznaniu do wersji zapoznawczej, ale należy włączyć ciągłe kopie zapasowe przed podjęciem próby odczytu ze zestawienia zmian we wszystkich wersjach i usunięciu.

Analizowanie obiektu odpowiedzi

Obiekt odpowiedzi to tablica elementów reprezentujących każdą zmianę. Różne właściwości zostaną wypełnione w zależności od typu zmiany. Obecnie nie ma możliwości pobrania poprzedniej wersji elementów dla operacji zastępowania lub usuwania.

• Tworzenie operacji

  {
    "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.>
    }
  }
  

• Operacje zastępowania

  {
    "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.>,
    }
  }
  

• Operacje usuwania

  {
    "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.>,
      "id": "<Id of the deleted item.>",
      "partitionKey": {
        "<Partition key property name>": "<Partition key property value>"
      }
    }
  }
  

Ograniczenia

• Obsługiwane w przypadku kont usługi Azure Cosmos DB dla noSQL. Inne typy kont usługi Azure Cosmos DB nie są obsługiwane.

• Do korzystania z tego trybu zestawienia zmian wymagane są ciągłe kopie zapasowe. Ograniczenia dotyczące używania ciągłej kopii zapasowej można znaleźć w dokumentacji.

• Odczytywanie zmian w kontenerze, które istniało przed włączeniem ciągłych kopii zapasowych na koncie, nie jest obsługiwane.

• Możliwość rozpoczęcia odczytywania zestawienia zmian od początku lub wybrania godziny rozpoczęcia na podstawie wcześniejszej sygnatury czasowej nie jest obecnie obsługiwana. Możesz rozpocząć od "teraz" lub z poprzedniej dzierżawy lub tokenu kontynuacji.

• Odbieranie poprzedniej wersji elementów, które zostały usunięte lub zaktualizowane, nie jest obecnie dostępne.

• Konta, które włączyły scalanie partycji, nie są obsługiwane.

Następne kroki

Dowiedz się więcej o kanale zmian w następujących artykułach:

• Omówienie zestawienia zmian
• Wzorce projektowe zestawienia zmian
• Opcje odczytu zestawienia zmian