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

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.

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.

• 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.

• 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.

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í:

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.

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

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í.