Csatornamódok módosítása az Azure Cosmos DB-ben

A KÖVETKEZŐRE VONATKOZIK: NoSQL

Az Azure Cosmos DB két változáscsatorna-módot kínál. Minden mód ugyanazokat az alapvető funkciókat kínálja. A különbségek közé tartoznak a hírcsatornában rögzített műveletek, az egyes módosításokhoz elérhető metaadatok és a módosítások megőrzési időtartama. A változáscsatornát különböző módokon használhatja fel ugyanazon Azure Cosmos DB-tároló több alkalmazásában az egyes számítási feladatok követelményeinek megfelelően. Minden egyes változáscsatorna-alkalmazás csak úgy konfigurálható, hogy egyetlen módban olvassa be a változáscsatornát. A változáscsatorna egy módban való használata nem tiltja meg, hogy a változáscsatornát egy másik módban használja egy másik alkalmazásban.

Feljegyzés

Van visszajelzése a változáscsatorna-módokkal kapcsolatban? Hallani akarjuk! Nyugodtan megoszthatja visszajelzéseit közvetlenül az Azure Cosmos DB mérnöki csapatával: cosmoschangefeed@microsoft.com.

Legújabb verziómódosítási mód

A legújabb verziómód a létrehozásokból és frissítésekből származó elemek módosításainak állandó rekordja. A tároló minden elemének legújabb verzióját kapja meg. Ha például létrehoz egy elemet, majd frissíti a módosítási hírcsatornát, akkor csak a frissített verzió jelenik meg a változáscsatornában. A rendszer nem rögzíti a törléseket módosításként, és ha töröl egy elemet, az már nem érhető el a hírcsatornában. A legújabb verziómódosítási mód alapértelmezés szerint engedélyezve van, és minden Azure Cosmos DB-fiókkal kompatibilis, kivéve a Table API-t és a PostgreSQL API-t. Korábban ez a mód volt az alapértelmezett módja a változáscsatorna felhasználásának.

Az összes verzió és törlés módosítja a hírcsatorna üzemmódját (előzetes verzió)

Az összes verzió és törlési mód (előzetes verzió) állandó rekord az elemek létrehozási, frissítési és törlési műveleteinek minden módosításáról. Az elemek minden egyes módosításáról a bekövetkezett sorrendben kap rekordot, beleértve az elemek köztes módosításait a változáscsatorna olvasásai között. Ha például egy elem létrejön, majd frissül a változáscsatorna elolvasása előtt, az elem létrehozási és frissítési verziói is megjelennek a változáscsatornában. Ha az összes verzióban és törlési módban szeretne olvasni a változáscsatornából, folyamatos biztonsági mentéseket kell konfigurálnia az Azure Cosmos DB-fiókhoz. A folyamatos biztonsági mentések bekapcsolása létrehozza az összes verziót, és törli a változáscsatornát. A változáscsatorna mód használatakor csak a folyamatos biztonsági mentési időszakon belül történt módosításokat olvashatja. Ez a mód csak az Azure Cosmos DB for NoSQL-fiókokkal kompatibilis. További információ az előzetes verzióra való regisztrációról.

Változáscsatorna használati esetei

Legújabb verziómód

A legújabb verziómód segítségével egyszerűen feldolgozhatja a tároló elemeinek valós idejű és korábbi módosításait is, így a tároló elejétől visszaléphet a változásokhoz.

Az alábbi forgatókönyvek jól illeszkednek ehhez a módhoz:

• Egy teljes tároló áttelepítése másodlagos helyre.

• A változások újrafeldolgozásának képessége a tároló elejétől kezdve.

• A tároló elemeinek változásainak valós idejű feldolgozása létrehozási és frissítési műveletek eredményeként.

• Olyan számítási feladatok, amelyeknek nem kell rögzíteni a törléseket vagy az olvasások közötti köztes változásokat.

Minden verzió és törlési mód (előzetes verzió)

A változáscsatorna minden verziója és törlése új forgatókönyveket tesz lehetővé a változáscsatorna számára, és leegyszerűsíti a többit. Elolvashatja az elemekben bekövetkezett összes módosítást (még akkor is, ha több változás történt a változáscsatorna olvasása között), azonosíthatja a feldolgozandó módosítások művelettípusát, és lekérheti a törlésekből eredő módosításokat.

Néhány gyakori forgatókönyv, amely lehetővé teszi és továbbfejleszti ezt a módot:

• Adatok valós idejű átvitele két hely között helyreállítható törlés implementálása nélkül.

• A logika növekményes változásokon alapuló aktiválása, ha egy adott elemhez több változási műveletre van szükség a változáscsatorna-lekérdezések között.

• Riasztások aktiválása törlési műveletek esetén, például naplózási forgatókönyvekben.

• Az elem feldolgozása művelettípustól függően eltérő módon hoz létre, frissít és töröl.

Az egyes üzemmódok funkciói

A változáscsatorna-üzemmódok gyakori funkciói mellett minden változáscsatorna mód a következő jellemzőkkel rendelkezik:

Legújabb verziómód

• A változáscsatorna tartalmazza a tároló elemeire végrehajtott beszúrási és frissítési műveleteket.

• A változáscsatorna ezen módja nem naplózza a törléseket. A törléseket úgy rögzítheti, hogy a törlés helyett egy "helyreállítható törlés" jelzőt állít be az elemeken belül. Hozzáadhat például egy attribútumot a hívott deleted elemhez az értékkel true, majd beállíthat egy élettartamot (TTL) az elemen. A változáscsatorna frissítésként rögzíti, és a TTL lejártakor az elem automatikusan törlődik. Azt is megteheti, hogy a TTL-funkcióval véges lejárati időt állít be az elemekhez. Ezzel a megoldással a TTL lejárati időszakánál rövidebb időintervallumon belül kell feldolgoznia a módosításokat.

• A változáscsatorna csak az adott elem legutóbbi módosítását tartalmazza. Előfordulhat, hogy a köztes módosítások nem érhetők el.

• Ha töröl egy elemet, az már nem érhető el a változáscsatornában.

• A módosítások bármikor szinkronizálhatók, és nincs rögzített adatmegőrzési időszak, amelyre a módosítások elérhetők.

• A változáscsatorna nem szűrhető egy adott művelettípusra. Az egyik lehetséges alternatíva, ha hozzáad egy "helyreállítható jelölőt" az elemhez a frissítésekhez, és a változáscsatorna elemeinek feldolgozásakor a jelölő alapján szűr.

• A változáscsatorna olvasásának kiindulópontja lehet a tároló elejétől, egy időponttól, egy "mostantól" vagy egy adott ellenőrzőponttól. A kezdési idő pontossága körülbelül öt másodperc.

Minden verzió és törlési mód (előzetes verzió)

• A változáscsatorna tartalmazza a tárolóban lévő elemek beszúrási, frissítési és törlési műveleteit. A TTL-lejáratok törlései is rögzítésre kerülnek.

• A metaadatok a változás típusának meghatározására szolgálnak, beleértve azt is, hogy a törlés TTL-lejárat miatt történt-e.

• A változáscsatorna elemei a módosítási idő sorrendjében jelennek meg. A TTL-lejáratok törlései nem garantáltan azonnal megjelennek a hírcsatornában az elem lejárata után. Ezek akkor jelennek meg, amikor az elem törlődik a tárolóból.

• A fiók folyamatos biztonsági mentéséhez beállított adatmegőrzési ablakban történt összes módosítás olvasható. A megőrzési időszakon kívül történt módosítások olvasásának megkísérlése hibát eredményez. Ha például a tároló nyolc nappal ezelőtt lett létrehozva, és a folyamatos biztonsági mentési időszak megőrzési ideje hét nap, akkor csak az elmúlt hét nap módosításait olvashatja.

• A változáscsatorna kezdőpontja lehet "most" vagy egy adott ellenőrzőpont a megőrzési időszakon belül. Ezzel a móddal nem olvashatja el a módosításokat a tároló elejétől vagy egy adott időponttól.

A változáscsatorna működése

Minden mód kompatibilis különböző módszerekkel az egyes nyelvek változáscsatornájának olvasásához.

Legújabb verziómód

A változáscsatorna módosításait a következő módokon használhatja a legújabb verzió módban:

A változáscsatorna olvasásának módja	.NET	Java	Python	Node.js
Adatcsatorna lekérési modelljének módosítása	Igen	Igen	Igen	Igen
Adatcsatorna processzorának módosítása	Igen	Igen	Nem	Nem
Azure Functions-eseményindító	Igen	Igen	Igen	Igen

A válaszobjektum elemzése

A legújabb verzió módban az alapértelmezett válaszobjektum olyan elemek tömbje, amelyek megváltoztak. Minden elem tartalmazza az Azure Cosmos DB-elemek szabványos metaadatait, beleértve _etag és _tsegy új tulajdonság _lsnhozzáadásával együtt.

A _etag formátum belső, és nem szabad függőséget vállalnia, mert bármikor megváltozhat. _ts módosítás vagy létrehozási időbélyeg. Időrendi összehasonlításhoz használható _ts . _lsn egy olyan kötegazonosító, amely csak a tranzakcióazonosítót képviselő változáscsatornához van hozzáadva. Sok elem rendelkezhet ugyanazokkal _lsn.

ETaga _etag/> FeedResponse az elemen láthatótól eltérő. _etag egy belső azonosító, amely az egyidejűség-vezérléshez használatos. A _etag tulajdonság az elem verzióját jelöli, míg a ETag tulajdonság a hírcsatorna sorrendbe tételére szolgál.

Minden verzió és törlési mód (előzetes verzió)

Az előzetes verzióban az alábbi módszerek érhetők el a változáscsatorna olvasásához az egyes ügyféloldali SDK-khoz:

A változáscsatorna olvasásának módja	.NET	Java	Python	Node.js
Adatcsatorna lekérési modelljének módosítása	>= 3.32.0-előzetes verzió	>= 4.42.0	Nem	Nem
Adatcsatorna processzorának módosítása	Nem	>= 4.42.0	Nem	Nem
Azure Functions-eseményindító	Nem	Nem	Nem	Nem

Feljegyzés

Az alkalmazásban konfigurált kapcsolati módtól függetlenül az összes verzióval és törléssel végrehajtott kérelem átjárómódot fog használni.

Első lépések

Az összes verzió használatának megkezdéséhez és a változáscsatorna mód törléséhez regisztráljon az előzetes verzióra az Azure-előfizetés áttekintési lapján, a Funkciók előnézete lapon . Keresse meg az AllVersionsAndDeletesChangeFeed funkciót, és válassza a Regisztráció lehetőséget.

A kérés elküldése előtt győződjön meg arról, hogy rendelkezik legalább egy Azure Cosmos DB-fiókkal az előfizetésben. Ez a fiók lehet egy meglévő fiók vagy egy új fiók, amelyet az előzetes verziójú funkció kipróbálásához hozott létre. Ha nem rendelkezik fiókkal az előfizetésben, amikor az Azure Cosmos DB csapata megkapja a kérést, a rendszer elutasítja a kérést, mert nincs olyan fiók, amelyre alkalmazni szeretné a funkciót.

Az Azure Cosmos DB csapata áttekinti a kérést, és e-mailben felveszi Önével a kapcsolatot, hogy megerősítse, mely Azure Cosmos DB-fiókokat szeretné regisztrálni az előzetes verzióban. Az előzetes verzió használatához folyamatos biztonsági mentéseket kell konfigurálni az Azure Cosmos DB-fiókhoz. A folyamatos biztonsági mentések az előzetes verzióba való felvétel előtt vagy után is engedélyezhetők, de a folyamatos biztonsági mentéseket engedélyezni kell, mielőtt az összes verzióban és törlési módban próbál meg olvasni a változáscsatornából.

A válaszobjektum elemzése

A válaszobjektum az egyes módosításokat képviselő elemek tömbje. A tömb a következő példához hasonlóan néz ki:

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

Korlátozások

• Az Azure Cosmos DB for NoSQL-fiókok esetében támogatott. Más Azure Cosmos DB-fióktípusok nem támogatottak.

• A változáscsatorna mód használatához folyamatos biztonsági mentésekre van szükség. A folyamatos biztonsági mentés használatának korlátai a dokumentációban találhatók.

• A fiók folyamatos biztonsági mentésének engedélyezése előtt meglévő tároló módosításainak olvasása nem támogatott.

• Jelenleg nem támogatott a változáscsatorna olvasásának megkezdése az elejétől, illetve a korábbi időbélyeg alapján történő kezdési időpont kiválasztása. A "most" vagy egy korábbi bérlet - vagy folytatási jogkivonatból indulhat ki.

• A frissített elemek korábbi verziójának fogadása jelenleg nem érhető el.

• Azok a fiókok, amelyek engedélyezték a partíciók egyesítését, nem támogatottak .

Következő lépések

További információ a változáscsatornáról az alábbi cikkekben:

• Változáscsatorna áttekintése
• A hírcsatorna tervezési mintáinak módosítása
• A változáscsatorna olvasásának beállításai