Změna režimů kanálu ve službě Azure Cosmos DB

PLATÍ PRO: NoSQL

Azure Cosmos DB nabízí dva režimy kanálu změn. Každý režim nabízí stejné základní funkce. Mezi rozdíly patří operace zachycené v informačním kanálu, metadata, která jsou k dispozici pro každou změnu, a dobu uchovávání změn. Kanál změn můžete využívat v různých režimech napříč několika aplikacemi pro stejný kontejner Azure Cosmos DB tak, aby vyhovoval požadavkům jednotlivých úloh. Jednotlivé aplikace kanálu změn je možné nakonfigurovat pouze pro čtení kanálu změn v jednom režimu. Využívání kanálu změn v jednom režimu nezakazuje využívání kanálu změn v jiném režimu v jiné aplikaci.

Poznámka:

Máte nějaký názor na režimy kanálu změn? Chceme to slyšet! Zpětnou vazbu můžete sdílet přímo s technickým týmem služby Azure Cosmos DB: cosmoschangefeed@microsoft.com

Nejnovější režim kanálu změn verzí

Nejnovější režim verze je trvalý záznam změn provedených u položek z vytváření a aktualizací. V kontejneru získáte nejnovější verzi každé položky. Pokud se například vytvoří položka a pak se aktualizuje před přečtením kanálu změn, zobrazí se v kanálu změn pouze aktualizovaná verze. Odstranění se nezachytí jako změny a po odstranění položky už nebude v informačním kanálu k dispozici. Režim kanálu změn nejnovější verze je ve výchozím nastavení povolený a je kompatibilní se všemi účty služby Azure Cosmos DB s výjimkou rozhraní API pro tabulky a rozhraní API for PostgreSQL. Tento režim byl dříve výchozím způsobem využívání kanálu změn.

Všechny verze a odstraní režim kanálu změn (Preview)

Všechny verze a režim odstranění (Preview) jsou trvalým záznamem všech změn položek z operací vytvoření, aktualizace a odstranění. Získáte záznam o každé změně položek v pořadí, v jakém k ní došlo, včetně přechodných změn položky mezi čtením kanálu změn. Pokud se například vytvoří a aktualizuje položka před přečtením kanálu změn, zobrazí se v kanálu změn jak verze vytvoření, tak aktualizace položky. Pokud chcete číst z kanálu změn ve všech verzích a v režimu odstraňování, musíte mít nakonfigurované průběžné zálohování pro účet služby Azure Cosmos DB. Zapnutí průběžného zálohování vytvoří všechny verze a odstraní kanál změn. Při použití tohoto režimu kanálu změn můžete číst pouze změny, ke kterým došlo během období průběžného zálohování. Tento režim je kompatibilní pouze s účty Azure Cosmos DB for NoSQL. Přečtěte si další informace o tom, jak si zaregistrovat verzi Preview.

Případy použití kanálu změn

Režim nejnovější verze

Nejnovější režim verze nabízí snadný způsob, jak zpracovat změny v reálném čase i historické změny položek v kontejneru s možností vrátit se k změnám od začátku kontejneru.

Pro tento režim jsou vhodné následující scénáře:

• Migrace celého kontejneru do sekundárního umístění

• Možnost znovu zpracovat změny od začátku kontejneru.

• Zpracování změn položek v kontejneru, které jsou výsledkem operací vytváření a aktualizace v reálném čase

• Úlohy, které nepotřebují zachytit odstranění nebo přechodné změny mezi čtením.

Všechny verze a režim odstranění (Preview)

Režim kanálu změn ve všech verzích a odstranění umožňuje nové scénáře kanálu změn a zjednodušuje ostatní. Můžete číst všechny změny, ke kterým došlo k položkám (i v případech, kdy došlo k několika změnám mezi čtením kanálu změn), identifikovat typ operace zpracování změn a získat změny, které jsou výsledkem odstranění.

Tento režim umožňuje a vylepšuje několik běžných scénářů:

• Přenos dat mezi dvěma umístěními v reálném čase bez implementace obnovitelného odstranění

• Aktivace logiky na základě přírůstkových změn, pokud se mezi dotazováním kanálu změn očekává více operací změn pro danou položku.

• Aktivace upozornění na operace odstranění, například ve scénářích auditování

• Schopnost zpracovávat položky vytváří, aktualizuje a odstraňuje odlišně na základě typu operace.

Funkce jednotlivých režimů

Kromě společných funkcí ve všech režimech kanálu změn má každý režim kanálu změn následující charakteristiky:

Režim nejnovější verze

• Kanál změn obsahuje operace vložení a aktualizace provedené u položek v kontejneru.

• Tento režim kanálu změn se neodstraní. Odstranění můžete zachytit tak, že v položkách nastavíte příznak obnovitelného odstranění, místo abyste je odstranili přímo. Můžete například přidat atribut do položky volanou deleted s hodnotou truea pak nastavit hodnotu TTL (Time to Live) položky. Kanál změn ho zachytí jako aktualizaci a položka se po vypršení platnosti hodnoty TTL automaticky odstraní. Alternativně můžete nastavit konečné období vypršení platnosti položek pomocí funkce TTL. V tomto řešení musíte změny zpracovat v kratším časovém intervalu, než je doba vypršení platnosti hodnoty TTL.

• Do kanálu změn je zahrnuta pouze nejnovější změna konkrétní položky. Přechodné změny nemusí být dostupné.

• Po odstranění položky už není v kanálu změn k dispozici.

• Změny je možné synchronizovat z libovolného bodu v čase a neexistuje žádná pevná doba uchovávání dat, pro kterou jsou změny k dispozici.

• Kanál změn nemůžete filtrovat pro konkrétní typ operace. Jednou z možných alternativ je přidání "měkké značky" u položky pro aktualizace a filtrování na základě značky při zpracování položek v kanálu změn.

• Výchozí bod pro čtení kanálu změn může být od začátku kontejneru, od bodu v čase, od "nyní" nebo z konkrétního kontrolního bodu. Přesnost času zahájení je přibližně pět sekund.

Všechny verze a režim odstranění (Preview)

• Kanál změn zahrnuje operace vložení, aktualizace a odstranění provedených u položek v kontejneru. Zachytí se také odstranění z vypršení platnosti hodnoty TTL.

• Metadata se poskytují k určení typu změny, včetně toho, jestli odstranění bylo kvůli vypršení platnosti hodnoty TTL.

• Položky kanálu změn přicházejí v pořadí jejich času úpravy. Odstranění z vypršení platnosti hodnoty TTL není zaručeno, že se v informačním kanálu zobrazí hned po vypršení platnosti položky. Zobrazí se, když se položka vyprázdní z kontejneru.

• Všechny změny, ke kterým došlo v okně uchovávání informací nastaveném pro průběžné zálohování v účtu, je možné číst. Při pokusu o čtení změn, ke kterým došlo mimo okno uchovávání informací, dojde k chybě. Pokud byl například kontejner vytvořen před osmi dny a doba uchovávání období průběžného zálohování je sedm dní, můžete číst jenom změny z posledních sedmi dnů.

• Výchozí bod kanálu změn může být od "teď" nebo z konkrétního kontrolního bodu v rámci doby uchovávání informací. Pomocí tohoto režimu nemůžete číst změny od začátku kontejneru ani z určitého bodu v čase.

Práce s kanálem změn

Každý režim je kompatibilní s různými metodami čtení kanálu změn pro každý jazyk.

Režim nejnovější verze

Pomocí následujících způsobů můžete využívat změny z kanálu změn v nejnovějším režimu verzí:

Metoda pro čtení kanálu změn	.NET	Java	Python	Node.js
Model vyžádání změn kanálu změn	Ano	Ano	Ano	Yes
Procesor kanálu změn	Ano	Ano	No	Ne
Trigger Služby Azure Functions	Ano	Ano	Ano	Yes

Parsování objektu odpovědi

V nejnovějším režimu verze je výchozí objekt odpovědi pole položek, které se změnily. Každá položka obsahuje standardní metadata pro libovolnou položku služby Azure Cosmos DB včetně _etag a _tss přidáním nové vlastnosti . _lsn

Formát _etag je interní a neměli byste na něm záviset, protože se může kdykoli změnit. _ts je úprava nebo časové razítko vytvoření. Můžete použít _ts pro chronologické porovnání. _lsn je ID dávky, které je přidáno pouze pro kanál změn, který představuje ID transakce. Mnoho položek může mít stejné _lsn.

ETag položka FeedResponse se liší od _etag položky, kterou vidíte. _etag je interní identifikátor a používá se k řízení souběžnosti. Vlastnost _etag představuje verzi položky, zatímco ETag vlastnost se používá k sekvencování informačního kanálu.

Všechny verze a režim odstranění (Preview)

Ve verzi Preview jsou pro každou klientskou sadu SDK k dispozici následující metody čtení kanálu změn:

Metoda pro čtení kanálu změn	.NET	Java	Python	Node.js
Model vyžádání změn kanálu změn	>= 3.32.0-preview	>= 4,42,0	No	>= 4,1,0
Procesor kanálu změn	No	>= 4,42,0	No	Ne
Trigger Služby Azure Functions	No	No	No	Číslo

Poznámka:

Bez ohledu na režim připojení nakonfigurovaný ve vaší aplikaci budou všechny požadavky provedené se všemi verzemi a odstranění kanálu změn používat režim brány.

Začínáme

Pokud chcete začít používat všechny verze a odstranit režim kanálu změn, zaregistrujte se ve verzi Preview prostřednictvím stránky s přehledem předplatného Azure. Vyhledejte funkci AllVersionsAndDeletesChangeFeed a vyberte Zaregistrovat.

Před odesláním žádosti se ujistěte, že máte v předplatném aspoň jeden účet služby Azure Cosmos DB. Tento účet může být existující nebo nový účet, který jste vytvořili, abyste si mohli vyzkoušet funkci Preview. Pokud v předplatném nemáte žádné účty, když tým Služby Azure Cosmos DB obdrží vaši žádost, žádost se odmítne, protože pro tuto funkci neexistují žádné účty.

Tým Azure Cosmos DB zkontroluje vaši žádost a kontaktuje vás prostřednictvím e-mailu a ověří, které účty Azure Cosmos DB v předplatném, které chcete zaregistrovat ve verzi Preview. Pokud chcete používat verzi Preview, musíte mít nakonfigurované průběžné zálohování pro váš účet služby Azure Cosmos DB. Průběžné zálohy je možné povolit buď před nebo po přijetí do verze Preview, ale průběžné zálohování musí být povolené, než se pokusíte číst z kanálu změn ve všech verzích a režimu odstranění.

Parsování objektu odpovědi

Objekt odpovědi je pole položek, které představují každou změnu. Pole vypadá jako v následujícím příkladu:

[
    {  
        "current": { 
            <The current version of the item that changed. All the properties of your item will appear here. This will be empty for delete operations.>
         },  
        "previous" : { 
            <The previous version of the item that changed. If the change was a delete operation, the item that was deleted will appear here. This will be empty for create and replace operations.>
         },  
        "metadata": {
            "lsn": <A number that represents the batch ID. Many items can have the same lsn.>, 
            "operationType": <The type of change, either 'create', 'replace', or 'delete'.>, 
            "previousImageLSN" : <A number that represents the batch ID of the change prior to this one.>, 
            "timeToLiveExpired" : <For delete changes, it will be 'true' if it was deleted due to a TTL expiration and 'false' if it wasn't.>, 
            "crts": <A number that represents the Conflict Resolved Timestamp. It has the same format as _ts.> 
        } 
    }
]

Omezení

• Podporuje se pro účty Azure Cosmos DB for NoSQL. Jiné typy účtů Služby Azure Cosmos DB se nepodporují.

• K používání tohoto režimu kanálu změn se vyžadují průběžné zálohování. Omezení používání průběžného zálohování najdete v dokumentaci.

• Čtení změn v kontejneru, který existoval před povolením průběžného zálohování v účtu, se nepodporuje.

• Možnost začít číst informační kanál změn od začátku nebo vybrat čas zahájení na základě předchozího časového razítka se v současné době nepodporuje. Můžete začít buď od "teď", nebo z předchozího tokenu zapůjčení nebo pokračování.

• Příjem předchozí verze položek, které byly aktualizovány, není aktuálně k dispozici.

• Účty, které povolily slučování oddílů, se nepodporují.

Další kroky

Další informace o kanálu změn najdete v následujících článcích:

• Přehled kanálu změn
• Vzory návrhu kanálu změn
• Možnosti čtení kanálu změn