Hinzufügen einer Azure Cosmos DB CDC-Quelle zu einem Eventstream
Dieser Artikel zeigt Ihnen, wie Sie eine Azure Cosmos DB (Azure Cosmos DB for NoSQL) Change Data Capture-Quelle zu einem Eventstream hinzufügen.
Mit dem Azure Cosmos DB Change Data Capture (CDC)-Quellen-Konnektor für Microsoft Fabric-Eventstreams können Sie eine Momentaufnahme der aktuellen Daten in einer Azure Cosmos DB-Datenbank erfassen. Künftige Änderungen an diesen Daten auf Zeilenebene werden dann vom Konnektor überwacht und aufgezeichnet. Sobald die Änderungen im Eventstream erfasst sind, können Sie diese CDC-Daten in Echtzeit verarbeiten und an verschiedene Ziele innerhalb von Fabric zur weiteren Verarbeitung oder Analyse senden.
Hinweis
Diese Quelle wird in den folgenden Regionen Ihrer Arbeitsbereichskapazität nicht unterstützt: USA, Westen 3; Schweiz, Westen.
Voraussetzungen
- Zugriff auf einen Arbeitsbereich im Fabric-Kapazitätslizenzmodus (oder) im Testlizenzmodus mit Mitwirkenden oder höheren Berechtigungen.
- Zugriff auf ein Azure Cosmos DB for NoSQL-Konto und eine Datenbank.
- Ihre Azure Cosmos DB for NoSQL-Datenbank muss öffentlich zugänglich sein und darf sich nicht hinter einer Firewall oder in einem Virtual Network befinden.
- Wenn Sie keinen Eventstream haben, erstellen Sie einen Eventstream.
Abrufen von Details zur Verbindung aus dem Azure-Portal
Die Bezeichnungen für die Artikel, die Sie aus dem Azure-Portal sammeln müssen, werden in den folgenden Schritten gezeigt. Sie benötigen immer den Endpunkt-URI in einem Format wie https://<account>.<api>.azure.com:<port>/dem Primärschlüssel und den Datenbanknamen und Artikel-IDs, für die Sie Daten sammeln möchten.
Hinweis
Azure Cosmos DB for NoSQL CDC verwendet den aktuellen Versionsmodus des Azure Cosmos DB-Änderungsfeed. Es erfasst die Änderungen an Datensätzen in der aktuellen Version. Beachten Sie, dass Löschungen mit diesem Modus nicht erfasst werden.
Wählen Sie auf der Seite des Azure-Portals für Ihr Azure Cosmos DB-Konto im linken Navigationsbereich die Option Schlüssel unter Einstellungen aus.
Kopieren Sie auf der Seite Schlüssel die URI- und Primärschlüssel-Werte, die zum Einrichten der Eventstream-Verbindung verwendet werden sollen.
Notieren Sie sich auf der Azure-Portal-Übersicht für Ihr Azure Cosmos DB-Konto die Datenbank und Artikel-ID, für die Sie Daten sammeln möchten.
Hinweis
Die maximale Anzahl der Quellen und Ziele für einen Eventstream beträgt 11.
Azure Cosmos DB (CDC) als eine Quelle hinzufügen
Wenn Sie Ihrem Eventstream noch keine Quelle hinzugefügt haben, wählen Sie die Kachel Externe Quelle verwenden aus.
Wenn Sie die Quelle zu einem bereits veröffentlichten Eventstream hinzufügen, wechseln Sie zum Bearbeitungsmodus, wählen Sie im Band Quelle hinzufügen und dann Externe Quellen aus.
Suchen Sie auf der Seite Datenquelle auswählen auf der Kachel Azure Event Hubs nach Verbinden, und wählen Sie Verbinden aus.
Konfigurieren und verbinden mit Azure Cosmos DB (CDC)
Wählen Sie auf der Anzeige Verbinden unter Verbindung die Option Neue Verbindung aus, um eine Cloudverbindung zu Ihrer Azure Cosmos DB-Datenbank zu erstellen.
Auf dem Tab Verbindungseinstellungen die folgenden Informationen eingeben:
- Cosmos DB-Endpunkt: Geben Sie den URI oder Endpunkt für Ihr Cosmos DB-Konto ein, das Sie aus dem Azure-Portal kopiert haben.
- Verbindungsname: Automatisch generiert, oder Sie können einen neuen Namen für diese Verbindung eingeben.
- Kontoschlüssel: Geben Sie den Primärschlüssel für Ihr Azure Cosmos DB-Konto ein, das Sie aus dem Azure-Portal kopiert haben.
Wählen Sie Verbinden.
Geben Sie die folgenden Informationen für Ihre Azure Cosmos DB-Ressourcen an, und wählen Sie dann Weiter aus.
Container-ID: Geben Sie den Namen des Azure Cosmos DB-Containers oder der Tabelle ein, mit dem Sie eine Verbindung herstellen möchten.
Datenbank: Geben Sie den Namen Ihrer Azure Cosmos DB-Datenbank ein.
Offsetrichtlinie: Wählen Sie aus, ob das Lesen Frühester oder Spätester Offsets gestartet werden soll, wenn kein Commit vorhanden ist.
Sie können den Quellnamen auch im Abschnitt Stream-Details auf der rechten Seite ändern, indem Sie die Stiftschaltfläche auswählen.
Überprüfen Sie auf der Seite Überprüfen + Verbinden die Zusammenfassung, und wählen Sie dann Hinzufügen aus.
Anzeigen des aktualisierten Eventstreams
Die Azure Cosmos DB (CDC)-Quelle wird Ihrem Eventstream im Bearbeitungsmodus hinzugefügt. Wählen Sie Veröffentlichen aus, um die Änderungen zu veröffentlichen und mit dem Streamen von Azure Cosmos DB CDC-Daten in den Eventstream zu beginnen.
Der Eventstream wird im Livemodus angezeigt. Wählen Sie im Menüband Bearbeiten aus, um zum Bearbeitungsmodus zurückzukehren, um den Eventstream zu aktualisieren.
Zugehöriger Inhalt
Andere Connectors: