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

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.

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.

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

• 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éseinek adatmegőrzési időszakában 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ódosításait a következő módokon használhatja a legújabb verzió módban:

A válaszobjektum elemzése

A legújabb verzió módban az alapértelmezett válaszobjektum a módosított elemek tömbje. 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.

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:

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 a kérés beérkezésekor nem rendelkezik fiókkal az előfizetésben, a rendszer elutasítja a kérést, mert nincsenek olyan fiókok, amelyekre 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 rendszer a módosítás típusától függően különböző tulajdonságokat tölt fel. Jelenleg nem lehet lekérni az elemek korábbi verzióját a csere- vagy törlési műveletekhez.

• Műveletek létrehozása

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

• Műveletek cseréje

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

• Törlési műveletek

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

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 törölt vagy frissített elemek korábbi verziójának fogadása jelenleg nem érhető el.

• A partíciók egyesítését engedélyező fiókok nem támogatottak .