Feedmodi wijzigen in Azure Cosmos DB

De nieuwste versiemodus biedt een eenvoudige manier om zowel realtime als historische wijzigingen in items in een container te verwerken met de mogelijkheid om vanaf het begin van de container terug te gaan naar wijzigingen.

Hier volgen scenario's die geschikt zijn voor deze modus:

• Migraties van een hele container naar een secundaire locatie.

• Mogelijkheid om wijzigingen vanaf het begin van de container opnieuw te verwerken.

• Real-time verwerking van wijzigingen van items in een container als gevolg van het maken en bijwerken.

• Workloads die geen verwijderingen of tussenliggende wijzigingen tussen het lezen hoeven vast te leggen.

De modus voor alle versies en verwijderingen in de wijzigingsfeed maakt nieuwe scenario's mogelijk en vereenvoudigt andere. U kunt elke wijziging lezen die is opgetreden in items (zelfs in gevallen waarin meerdere wijzigingen zijn opgetreden tussen wijzigingenfeedlees), het bewerkingstype van wijzigingen identificeren dat wordt verwerkt en wijzigingen ophalen die het gevolg zijn van verwijderingen.

Een aantal veelvoorkomende scenario's die in deze modus worden ingeschakeld en verbeterd, zijn:

• Real-time overdracht van gegevens tussen twee locaties zonder een zachte verwijdering te implementeren.

• Het activeren van logica op basis van incrementele wijzigingen als er meerdere wijzigingsbewerkingen voor een bepaald item worden verwacht tussen polls voor wijzigingenfeeds.

• Het activeren van waarschuwingen voor verwijderingsbewerkingen, zoals bij auditscenario's.

• De mogelijkheid om het aanmaken, bijwerken en verwijderen van items verschillend te verwerken afhankelijk van het bewerkingstype.

• De wijzigingsfeed bevat invoeg- en updatebewerkingen aan items in de container.

• In deze modus van de wijzigingenfeed worden geen verwijderingen vastgelegd. U kunt verwijderingen vastleggen door een "soft-delete" markering in te stellen op uw items in plaats van ze rechtstreeks te verwijderen. U kunt bijvoorbeeld een kenmerk toevoegen in het item deleted met de waarde trueen vervolgens een TTL (Time to Live) instellen voor het item. De wijzigingenfeed legt deze vast als een update en het item wordt automatisch verwijderd wanneer de TTL verloopt. U kunt ook een eindige verloopperiode voor uw items instellen met behulp van de TTL-functie. Met deze oplossing moet u de wijzigingen binnen een korter tijdsinterval verwerken dan de TTL-verloopperiode.

• Alleen de meest recente wijziging voor een specifiek item wordt opgenomen in de wijzigingenfeed. Tussenliggende wijzigingen zijn mogelijk niet beschikbaar.

• Wanneer een item wordt verwijderd, is het niet meer beschikbaar in de wijzigingenfeed.

• Wijzigingen kunnen vanaf elk moment worden gesynchroniseerd en er is geen vaste gegevensretentieperiode waarvoor wijzigingen beschikbaar zijn.

• U kunt de wijzigingenfeed niet filteren op een specifiek type bewerking. Een mogelijk alternatief is om een 'zachte markering' toe te voegen aan het item voor updates en filteren op basis van de markering wanneer u items in de wijzigingenfeed verwerkt.

• Het beginpunt voor het lezen van de wijzigingenfeed kan afkomstig zijn van het begin van de container, vanaf een bepaald tijdstip, van 'nu' of van een specifiek controlepunt. De precisie van de begintijd is ongeveer vijf seconden.

• De wijzigingenfeed bevat invoeg-, update- en verwijderbewerkingen die zijn aangebracht in items in de container. Verwijderingen van ttl-tijdslimieten worden ook geregistreerd.

• Metagegevens worden opgegeven om het wijzigingstype te bepalen, inclusief of een verwijdering is veroorzaakt door een TTL-vervaldatum.

• Wijzigingsfeeditems komen in volgorde van de wijzigingstijd. Items die in het bereik van een transactionele batch, opgeslagen procedure of bulkmodusaanvraag zijn geschreven, hebben dezelfde wijzigingstijd en wijzigingen binnen dat bereik kunnen in elke volgorde worden geleverd. Verwijderingen vanwege TTL-vervaldatums verschijnen mogelijk niet direct in de feed zodra het item is verlopen. Ze worden weergegeven wanneer het item uit de container wordt verwijderd.

• Alle wijzigingen die zijn opgetreden in het bewaarvenster voor continue back-ups in het account, kunnen worden gelezen. Als u wijzigingen probeert te lezen die buiten het bewaarvenster zijn opgetreden, treedt er een fout op. Als uw container bijvoorbeeld acht dagen geleden is gemaakt en de bewaarperiode voor continue back-upperiode zeven dagen is, kunt u alleen wijzigingen van de afgelopen zeven dagen lezen.

• Het beginpunt van de wijzigingenfeed kan vanaf 'nu' of van een specifiek controlepunt binnen uw bewaarperiode zijn. U kunt wijzigingen vanaf het begin van de container of vanaf een bepaald tijdstip niet lezen met behulp van deze modus.

U kunt de volgende manieren gebruiken om wijzigingen uit de wijzigingenfeed te gebruiken in de nieuwste versiemodus:

Het antwoordobject parseren

In de meest recente versiemodus is het standaardantwoordobject een matrix met items die zijn gewijzigd. Elk item bevat de standaardmetagegevens voor elk Azure Cosmos DB-item, inclusief _etag en _ts, met de toevoeging van een nieuwe eigenschap, _lsn.

De _etag indeling is intern en u moet er geen afhankelijkheid van nemen, omdat deze op elk gewenst moment kan worden gewijzigd. _ts is een wijzigings- of aanmaaktijdstempel. U kunt deze gebruiken _ts voor chronologische vergelijking. _lsn is een batch-id die alleen wordt toegevoegd voor de wijzigingenfeed die de transactie-id vertegenwoordigt. Veel items kunnen hetzelfde _lsnhebben.

ETag op FeedResponse is anders dan _etag dat u ziet op het item. _etag is een interne id en wordt gebruikt voor gelijktijdigheidscontrole. De _etag eigenschap vertegenwoordigt de versie van het item, terwijl de ETag eigenschap wordt gebruikt om de feed te orden.

Tijdens de preview zijn de volgende methoden om de wijzigingenfeed te lezen beschikbaar voor elke client-SDK:

Aan de slag

Als u aan de slag wilt gaan met alle versies en de wijzigingsfeedmodus wilt verwijderen, gaat u naar de pagina Functies in uw Azure Cosmos DB-account. Selecteer en schakel de functie Alle versies en verwijderingen wijzigingenfeedmodus (preview) in. U moet doorlopende back-ups hebben geconfigureerd voor uw Azure Cosmos DB-account voordat u de functie inschakelt. Het inschakelen kan tot 30 minuten duren en er kunnen gedurende deze tijd geen andere wijzigingen in het account worden aangebracht.

U kunt ook alle versies en de modus Verwijderen inschakelen voor een bestaand account met de REST API door "enableAllVersionsAndDeletesChangeFeed" : true toe te voegen aan de properties van uw account. Deze eigenschap is beschikbaar in de preview-API-versie 2024-12-01-preview of hoger. Het inschakelen van deze functie tijdens het maken van accounts wordt niet ondersteund.

Het antwoordobject parseren

Het antwoordobject is een matrix met items die elke wijziging vertegenwoordigen. Verschillende eigenschappen worden ingevuld, afhankelijk van het wijzigingstype. Er is momenteel geen manier om de vorige versie van items op te halen voor vervangings- of verwijderbewerkingen.

• Bewerkingen aanmaken

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

• Vervangingsoperaties

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

• Verwijder-bewerkingen

  {
    "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.>,
      "timeToLiveExpired" : <'true' if it was deleted due to a TTL expiration.>,
      "id": "<Id of the deleted item.>",
      "partitionKey": {
        "<Partition key property name>": "<Partition key property value>"
      }
    }
  }
  

Beperkingen

• Ondersteund voor Azure Cosmos DB voor NoSQL-accounts. Andere Azure Cosmos DB-accounttypen worden niet ondersteund.

• Continue back-ups zijn vereist voor het gebruik van deze wijzigingsfeedmodus. Raadpleeg de beperkingen van het gebruik van continue back-ups.

• De mogelijkheid om de wijzigingenfeed vanaf het begin te lezen of om een begintijd te selecteren op basis van een eerdere tijdstempel, wordt momenteel niet ondersteund. U kunt beginnen met "nu" of vanaf een vorige lease of vervolgtoken.

• Het ontvangen van de vorige versie van items die zijn verwijderd of bijgewerkt, is momenteel niet beschikbaar.

• Accounts waarvoor het samenvoegen van partities is ingeschakeld, worden niet ondersteund.