Hinzufügen von AZURE SQL Managed Instance (MI)-Datenbank (DB) CDC als Quelle im Echtzeithub

In diesem Artikel wird beschrieben, wie Sie azure SQL Managed Instance CDC als Ereignisquelle im Fabric Real-Time-Hub hinzufügen.

Der CDC Source Connector der Azure SQL Managed Instance CDC ermöglicht es Ihnen, einen Snapshot der aktuellen Daten in einer SQL Managed Instance-Datenbank zu 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.

Voraussetzungen

• Zugriff auf einen Arbeitsbereich im Fabric-Kapazitätslizenzmodus (oder) im Testlizenzmodus mit Mitwirkenden oder höheren Berechtigungen.
• Eine ausgeführte Azure SQL Managed Instance-Datenbank.
• Ihre von Azure SQL verwaltete Instanz muss einen öffentlichen Endpunkt aktivieren und nicht hinter einer Firewall oder in einem virtuellen Netzwerk geschützt sein.
• CDC in Ihrer Azure SQL Managed Instance durch Ausführen der gespeicherten Prozedur sys.sp_cdc_enable_dbaktiviert. Weitere Informationen finden Sie unter Aktivieren und Deaktivieren von Change Data Capture.

Aktivieren des öffentlichen Endpunkts in Ihrer verwalteten Azure SQL-Instanz

Wechseln Sie zum Azure-Portal, öffnen Sie Ihre verwaltete Azure SQL-Instanz, wählen Sie Netzwerkaus, und aktivieren Sie den öffentlichen Endpunkt.

Aktivieren von CDC in Ihrer Azure SQL Managed Instance

1. Aktivieren Sie CDC für die Datenbank.

   EXEC sys.sp_cdc_enable_db; 
   

2. Aktivieren Sie CDC für eine Tabelle mithilfe einer Gating-Rollenoption. In diesem Beispiel MyTable ist der Name der SQL-Tabelle.

   EXEC sys.sp_cdc_enable_table 
      @source_schema = N'dbo', 
      @source_name   = N'MyTable', 
      @role_name     = NULL 
   GO 
   

   Nachdem die Abfrage erfolgreich ausgeführt wurde, haben Sie CDC in Ihrer verwalteten Azure SQL-Instanz aktiviert.

Abrufen von Ereignissen aus Azure SQL Managed Instance (CDC)

Sie können Ereignisse aus einer Azure SQL Managed Instance (MI) Database (DB) CDC auf eine der folgenden Arten in Echtzeit abrufen:

• Verwendung der Seite Datenquellen
• Verwenden der Seite Microsoft-Quellen

Datenquellenseite

1. Melden Sie sich bei Microsoft Fabric an.

2. Wenn unten links auf der Seite Power BI angezeigt wird, wechseln Sie zur Fabric-Workload, indem Sie Power BI und dann Fabric auswählen.

   

3. Wählen Sie auf der linken Navigationsleiste den Echtzeithub aus.

   

4. Die Streamingdatenseite wird standardmäßig geöffnet. Klicken Sie auf die Schaltfläche " Daten hinzufügen ", um zur Seite " Datenquellen " zu gelangen.

   

   Sie können auch direkt zur Seite " Datenquellen " gelangen, indem Sie in der linken Navigationsleiste die Option " Daten hinzufügen " auswählen.

   

4. Wählen Sie auf der Seite Datenquellen oben die Kategorie Datenbank-CDC und dann auf der Kachel Azure SQL MI DB (CDC) die Option Verbinden aus.

   

   Verwenden Sie Anweisungen aus dem Abschnitt Azure SQL Managed Instance CDC als Quelle hinzufügen.

Seite Microsoft-Quellen

1. Wählen Sie im Echtzeithub Microsoft-Quellen im linken Navigationsmenü aus.

2. Wählen Sie in der Dropdownliste QuelleAzure SQL MI DB (CDC)aus.

3. Wählen Sie für Abonnement ein Azure-Abonnement aus, das über die Ressourcengruppe mit Ihrer Azure SQL Managed Instance-Datenbank verfügt.

4. Wählen Sie unter Ressourcengruppe eine Ressourcengruppe mit der Datenbank aus.

5. Wählen Sie für Region einen Standort aus, an dem sich Ihre Datenbank befindet.

6. Bewegen Sie nun den Mauszeiger über den Namen der Azure SQL Managed Instance DB CDC-Quelle, die Sie in der Liste der Datenbanken mit dem Echtzeithub verbinden möchten, und wählen Sie die Schaltfläche Verbinden aus, oder wählen Sie ... (Auslassungspunkte), und wählen Sie dann die Schaltfläche Verbinden aus.

   

   Um Verbindungsinformationen zu konfigurieren, führen Sie die Schritte aus dem Add Azure SQL Managed Instance CDC als Quellabschnitt aus.

Hinzufügen von CDC für verwaltete Azure SQL-Instanzen als Quelle

1. Wählen Sie auf der Seite Verbinden die Option Neue Verbindung aus.

   

2. Geben Sie im Abschnitt Verbindungseinstellungen die folgenden Werte für Ihren SQL Server auf einem virtuellen Computer ein:

   • Server: Geben Sie den Endpunkt aus dem Azure-Portal ein, und ersetzen Sie das Komma zwischen Host und Port durch einen Doppelpunkt. Wenn Ihr Endpunkt beispielsweise lautet xxxxx.public.xxxxxx.database.windows.net,3342, sollten Sie das xxxxx.public.xxxxxx.database.windows.net:3342 eingeben.

     

   • Datenbank: Geben Sie den Namen der Datenbank ein, mit der Sie eine Verbindung in Ihrer von Azure SQL verwalteten Instanz herstellen möchten.

     

3. Scrollen Sie nach unten und gehen Sie im Abschnitt Anmeldedaten für die Verbindung folgendermaßen vor:

   • Geben Sie für Verbindungsname einen Namen für die Verbindung ein.

   • Wählen Sie für Authentifizierungsart die Option Standard aus.

     Hinweis

     Fabric-Eventstreams unterstützen derzeit nur die Standardauthentifizierung.

   • Geben Sie Benutzernamen und Kennwort für den SQL Server auf dem virtuellen Computer ein.

4. Wählen Sie am unteren Rand der Seite die Option Verbinden aus.

5. Wählen Sie nun auf der Seite "Verbinden " die Option "Alle Tabellen" aus, oder geben Sie "Tabellenname(n)" ein. Wenn Sie letzteres auswählen, geben Sie Tabellen mithilfe einer durch Trennzeichen getrennten Liste mit vollständigen Tabellenbezeichnern (schemaName.tableName) oder gültigen regulären Ausdrücken an. Beispiel:

   • Verwenden Sie dbo.test.*, um alle Tabellen auszuwählen, deren Namen mit dbo.test beginnen.
   • Verwenden Sie dbo\.(test1|test2), um dbo.test1 und dbo.test2 auszuwählen.

   Sie können beide Formate in der Liste kombinieren. Die Gesamtzeichenbeschränkung für den gesamten Eintrag beträgt 102.400 Zeichen.

6. Sie können die Erweiterten Einstellungen aufklappen, um den Dezimalbehandlungsmodus zu konfigurieren, der angibt, wie der Konnektor die Spaltenwerte DECIMAL und NUMERIC behandelt.

   • Precise: Stellt Werte mithilfe exakter Dezimaltypen dar (z. B. Java BigDecimal), um die volle Genauigkeit und Genauigkeit in der Datendarstellung sicherzustellen.
   • Double: Wandelt Werte in Gleitkommazahlen mit doppelter Genauigkeit um. Dies verbessert die Benutzerfreundlichkeit und Leistung, kann aber zu einem Genauigkeitsverlust führen.
   • String: Codiert Werte als formatierte Zeichenfolgen. Dies erleichtert die Nutzung in nachgelagerten Systemen, verliert jedoch semantische Informationen über den ursprünglichen numerischen Typ.

7. Wählen Sie Weiter aus.

   

8. Überprüfen Sie auf der Seite Überprüfen + Verbinden die Zusammenfassung, und wählen Sie dann Verbinden aus.

   

Stream-Details anzeigen

1. Wenn Sie auf der Seite Überprüfen + Verbinden den Ereignisstream öffnen, öffnet der Assistent den Ereignisstream, den er für Sie mit dem ausgewählten Azure SQL MI DB CDC als Quelle erstellt hat. Um den Assistenten zu schließen, wählen Sie "Schließen" oder "X*" in der oberen rechten Ecke der Seite aus.
2. Sie sollten den Stream im Abschnitt "Aktuelle Streamingdaten" der Startseite desReal-Time-Hubs sehen. Ausführliche Schritte finden Sie unter Anzeigen von Details zu Streams im Fabric-Echtzeithub.

Zugehöriger Inhalt

Weitere Informationen zum Konsumieren von Streams finden Sie in den folgenden Artikeln:

• Verarbeiten von Streams
• Analysieren von Streams
• Einstellen von Warnungen für Streams