Delen via

Azure Cosmos DB CDC-bron toevoegen aan een eventstream

  • Artikel

In dit artikel leest u hoe u een Azure Cosmos DB (Azure Cosmos DB for NoSQL) Change Data Capture-bron toevoegt aan een eventstream.

Met de Azure Cosmos DB Change Data Capture-bronconnector (CDC) voor Microsoft Fabric-gebeurtenisstromen kunt u een momentopname van de huidige gegevens in een Azure Cosmos DB-database vastleggen. De connector bewaakt en registreert toekomstige wijzigingen op rijniveau in deze gegevens. Zodra de wijzigingen zijn vastgelegd in de eventstream, kunt u deze CDC-gegevens in realtime verwerken en verzenden naar verschillende bestemmingen in Fabric voor verdere verwerking of analyse.

Notitie

Deze bron wordt niet ondersteund in de volgende regio's van uw werkruimtecapaciteit: VS - west 3, Zwitserland - west.

Vereisten

  • Toegang tot een werkruimte in de licentiemodus voor infrastructuurcapaciteit (of) de modus Voor proeflicenties met inzender- of hogere machtigingen.
  • Toegang tot een Azure Cosmos DB for NoSQL-account en -database.
  • Uw Azure Cosmos DB for NoSQL-database moet openbaar toegankelijk zijn en zich niet achter een firewall bevinden of zijn beveiligd in een virtueel netwerk.
  • Als u geen eventstream hebt, maakt u een eventstream.

Verbindingsgegevens ophalen uit Azure Portal

De labels voor de items die u wilt verzamelen uit Azure Portal, worden weergegeven in de volgende stappen. U hebt altijd de eindpunt-URI nodig, in een indeling zoals https://<account>.<api>.azure.com:<port>/de primaire sleutel en de databasenaam en item-id's waarvoor u gegevens wilt verzamelen.

Notitie

Azure Cosmos DB for NoSQL CDC maakt gebruik van de nieuwste versiemodus van de Wijzigingenfeed van Azure Cosmos DB. Hiermee worden de wijzigingen in records vastgelegd in de nieuwste versie. Houd er rekening mee dat verwijderingen niet met deze modus worden vastgelegd.

  1. Selecteer op de azure-portalpagina voor uw Azure Cosmos DB-account sleutels onder Instellingen in het linkernavigatievenster.

  2. Kopieer op de pagina Sleutels de URI - en primaire-sleutelwaarden die moeten worden gebruikt voor het instellen van de eventstream-verbinding.

    Een schermopname van de URI en primaire sleutel op de pagina Azure Cosmos DB-sleutels in Azure Portal.

  3. Noteer op de overzichtspagina van Azure Portal voor uw Azure Cosmos DB-account de database- en item-id waarvoor u gegevens wilt verzamelen.

    Een schermopname van de lijst met containers voor een NoSQL-API-account van Azure Cosmos DB.

Notitie

Het maximum aantal bronnen en bestemmingen voor één eventstream is 11.

Azure Cosmos DB (CDC) toevoegen als bron

Als u nog geen bron aan uw eventstream hebt toegevoegd, selecteert u De tegel Externe bron gebruiken.

Schermopname van de selectie van de tegel Externe bron gebruiken.

Als u de bron toevoegt aan een al gepubliceerde gebeurtenisstroom, schakelt u over naar de bewerkingsmodus, selecteert u Bron toevoegen op het lint en selecteert u Vervolgens Externe bronnen.

Schermopname van de selectie van het menu Bron toevoegen aan externe bronnen.  

Zoek en selecteer Verbinding maken op de tegel Azure Event Hubs op de pagina Een gegevensbron selecteren.

Schermopname van de selectie van Azure Cosmos DB (CDC) als het brontype in de wizard Een gegevensbron selecteren.

Configureren en verbinding maken met Azure Cosmos DB (CDC)

  1. Selecteer in het scherm Verbinding maken onder Verbinding de optie Nieuwe verbinding om een cloudverbinding te maken die is gekoppeld aan uw Azure Cosmos DB-database.

    Schermopname van de pagina Verbinding maken met de koppeling Nieuwe verbinding geselecteerd.

  2. Voer in het scherm Verbindingsinstellingen de volgende gegevens in:

    • Cosmos DB-eindpunt: voer de URI of het eindpunt in voor uw Cosmos DB-account dat u hebt gekopieerd uit Azure Portal.
    • Verbindingsnaam: automatisch gegenereerd of u kunt een nieuwe naam voor deze verbinding invoeren.
    • Accountsleutel: Voer de primaire sleutel in voor uw Azure Cosmos DB-account dat u hebt gekopieerd uit Azure Portal.

    Een schermopname van de verbindingsinstellingen voor de Azure Cosmos DB CDC-bron.

  3. Selecteer Verbinding maken.

  4. Geef de volgende informatie op voor uw Azure Cosmos DB-resources en selecteer vervolgens Volgende.

    • Container-id: voer de naam in van de Azure Cosmos DB-container of -tabel waarmee u verbinding wilt maken.

    • Database: Voer de naam van uw Azure Cosmos DB-database in.

    • Verschuivingsbeleid: geef aan of u de eerste of laatste verschuivingen wilt lezen als er geen doorvoer is.

      U kunt ook de naam van de bron wijzigen in de sectie Stream-details aan de rechterkant door de knop Potlood te selecteren.

      Een schermopname van de verbindingsgegevens voor de Azure Cosmos DB CDC-bron.

  5. Controleer op de pagina Controleren en verbinden de samenvatting en selecteer Vervolgens Toevoegen.

    Schermopname van de pagina Beoordelen en verbinden voor de Azure Cosmos DB CDC-bron.

Bijgewerkte eventstream weergeven

  1. U ziet dat de Azure Cosmos DB-bron (CDC) is toegevoegd aan uw eventstream in de bewerkingsmodus. Selecteer Publiceren om de wijzigingen te publiceren en azure Cosmos DB CDC-gegevens naar de eventstream te streamen.

    Een schermopname van de toegevoegde Azure Cosmos DB CDC-bron in de bewerkingsmodus met de knop Publiceren gemarkeerd.

  2. U ziet de eventstream in de livemodus. Selecteer Bewerken op het lint om terug te gaan naar de bewerkingsmodus om de eventstream bij te werken.

    Een schermopname van de gepubliceerde gebeurtenisstream met Azure Cosmos DB-bron in Live View.

Gerelateerde inhoud

Andere connectors: