Feedmodi wijzigen in Azure Cosmos DB

VAN TOEPASSING OP: NoSQL

Azure Cosmos DB biedt twee modi voor wijzigingenfeeds. Elke modus biedt dezelfde kernfunctionaliteit. Verschillen zijn de bewerkingen die zijn vastgelegd in de feed, de metagegevens die beschikbaar zijn voor elke wijziging en de bewaarperiode van wijzigingen. U kunt de wijzigingenfeed in verschillende modi gebruiken voor meerdere toepassingen voor dezelfde Azure Cosmos DB-container om aan de vereisten van elke workload te voldoen. Elke afzonderlijke wijzigingsfeedtoepassing kan alleen worden geconfigureerd om de wijzigingenfeed in één modus te lezen. Als u de wijzigingenfeed in de ene modus gebruikt, kunt u de wijzigingenfeed niet gebruiken in een andere modus in een andere toepassing.

Notitie

Hebt u feedback over de modi voor wijzigingenfeeds? We willen het horen! U kunt feedback rechtstreeks delen met het technische team van Azure Cosmos DB: cosmoschangefeed@microsoft.com.

Laatste versie van wijzigingenfeedmodus

De nieuwste versiemodus is een permanente record van wijzigingen die zijn aangebracht in items van maken en bijwerken. U krijgt de nieuwste versie van elk item in de container. Als er bijvoorbeeld een item wordt gemaakt en vervolgens wordt bijgewerkt voordat u de wijzigingenfeed leest, wordt alleen de bijgewerkte versie weergegeven in de wijzigingenfeed. Verwijderingen worden niet vastgelegd als wijzigingen en wanneer een item wordt verwijderd, is het niet meer beschikbaar in de feed. De nieuwste versie van de wijzigingsfeedmodus is standaard ingeschakeld en is compatibel met alle Azure Cosmos DB-accounts, met uitzondering van de API voor Table en de API voor PostgreSQL. Deze modus was voorheen de standaard manier om de wijzigingenfeed te gebruiken.

Alle versies en verwijdert de wijzigingsfeedmodus (preview)

Alle versies en verwijderingsmodus (preview) is een permanente record van alle wijzigingen in items van bewerkingen voor maken, bijwerken en verwijderen. U krijgt een record van elke wijziging in items in de volgorde waarin deze is opgetreden, inclusief tussenliggende wijzigingen in een item tussen leesbewerkingen van wijzigingenfeeds. Als er bijvoorbeeld een item wordt gemaakt en vervolgens wordt bijgewerkt voordat u de wijzigingenfeed leest, worden zowel de create- als de updateversies van het item weergegeven in de wijzigingenfeed. Als u wilt lezen uit de wijzigingenfeed in alle versies en de modus Voor verwijderen, moet u doorlopende back-ups hebben geconfigureerd voor uw Azure Cosmos DB-account. Als u continue back-ups inschakelt, worden alle versies gemaakt en worden wijzigingenfeed verwijderd. U kunt alleen wijzigingen lezen die zijn opgetreden in de continue back-upperiode wanneer u deze wijzigingsfeedmodus gebruikt. Deze modus is alleen compatibel met Azure Cosmos DB voor NoSQL-accounts. Meer informatie over hoe u zich kunt registreren voor de preview.

Use cases voor wijzigingenfeed

Meest recente versiemodus

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.

• Realtime verwerking van wijzigingen in items in een container die het gevolg is van het maken en bijwerken van bewerkingen.

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

Alle versies en verwijdermodus (preview)

Met de alle versies en verwijderingen van de wijzigingsfeedmodus worden nieuwe scenario's voor wijzigingenfeeds mogelijk en worden andere scenario's vereenvoudigd. 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:

• Realtime overdracht van gegevens tussen twee locaties zonder een voorlopig verwijderen 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.

• Waarschuwingen activeren voor verwijderingsbewerkingen, zoals in controlescenario's.

• De mogelijkheid om item te verwerken, wordt anders gemaakt, bijgewerkt en verwijderd op basis van het bewerkingstype.

Functies van elke modus

Naast de algemene functies in alle modi voor wijzigingenfeeds heeft elke wijzigingsfeedmodus de volgende kenmerken:

Meest recente versiemodus

• De wijzigingenfeed bevat invoeg- en updatebewerkingen die worden aangebracht in items in de container.

• In deze modus van de wijzigingenfeed worden geen verwijderingen vastgelegd. U kunt verwijderingen vastleggen door een vlag voor voorlopig verwijderen in te stellen in 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.

Alle versies en verwijdermodus (preview)

• De wijzigingenfeed bevat invoeg-, update- en verwijderbewerkingen die zijn aangebracht in items in de container. Verwijderingen van TTL-vervaldatums worden ook vastgelegd.

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

• Wijzigingenfeeditems komen in de volgorde van hun wijzigingstijd. Verwijderingen van TTL-vervaldatums worden niet gegarandeerd weergegeven in de feed direct nadat het item is verlopen. Ze worden weergegeven wanneer het item uit de container wordt verwijderd.

• Alle wijzigingen die zijn opgetreden in het bewaarvenster dat is ingesteld 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.

Werken met de wijzigingenfeed

Elke modus is compatibel met verschillende methoden om de wijzigingenfeed voor elke taal te lezen.

Meest recente versiemodus

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

Methode voor het lezen van wijzigingenfeed	.NET	Java	Python	Node.js
Pull-model voor wijzigingenfeed	Ja	Ja	Ja	Ja
Wijzigingenfeedprocessor	Ja	Ja	No	Nr.
Azure Functions-trigger	Ja	Ja	Ja	Ja

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 is FeedResponse anders dan het _etag item dat u ziet. _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.

Alle versies en verwijdermodus (preview)

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

Methode voor het lezen van wijzigingenfeed	.NET	Java	Python	Node.js
Pull-model voor wijzigingenfeed	>= 3.32.0-preview	>= 4.42.0	Nee	Nr.
Wijzigingenfeedprocessor	Nee	>= 4.42.0	Nee	Nr.
Azure Functions-trigger	Nee	No	No	Nr.

Notitie

Ongeacht de verbindingsmodus die is geconfigureerd in uw toepassing, worden alle aanvragen die zijn gedaan met alle versies en verwijderingen van de wijzigingenfeed gebruikt de gatewaymodus.

Aan de slag

Als u aan de slag wilt gaan met alle versies en de wijzigingsfeedmodus wilt verwijderen, registreert u zich in de preview-versie via de pagina Preview-functies op de overzichtspagina van uw Azure-abonnement. Zoek de functie AllVersionsAndDeletesChangeFeed en selecteer Registreren.

Voordat u uw aanvraag indient, moet u ervoor zorgen dat u ten minste één Azure Cosmos DB-account in het abonnement hebt. Dit account kan een bestaand account zijn of een nieuw account dat u hebt gemaakt om de preview-functie uit te proberen. Als u geen accounts in het abonnement hebt wanneer het Azure Cosmos DB-team uw aanvraag ontvangt, wordt de aanvraag geweigerd omdat er geen accounts zijn waarop de functie moet worden toegepast.

Het Azure Cosmos DB-team beoordeelt uw aanvraag en neemt contact met u op via e-mail om te bevestigen welke Azure Cosmos DB-accounts in het abonnement dat u wilt inschrijven in de preview. Als u de preview wilt gebruiken, moet er continue back-ups zijn geconfigureerd voor uw Azure Cosmos DB-account. Continue back-ups kunnen worden ingeschakeld voor of nadat ze zijn toegelaten tot de preview, maar continue back-ups moeten zijn ingeschakeld voordat u probeert te lezen uit de wijzigingenfeed in alle versies en de modus Voor verwijderen.

Het antwoordobject parseren

Het antwoordobject is een matrix met items die elke wijziging vertegenwoordigen. De matrix ziet er als volgt uit:

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

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. De beperkingen voor het gebruik van continue back-ups vindt u in de documentatie.

• Het lezen van wijzigingen in een container die bestond voordat continue back-ups op het account zijn ingeschakeld, wordt niet ondersteund.

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

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

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

Volgende stappen

Meer informatie over wijzigingenfeed vindt u in de volgende artikelen:

• Overzicht van wijzigingenfeed
• Ontwerppatronen voor wijzigingenfeeds
• Opties voor het lezen van wijzigingenfeed