Konfigurieren von Event Hubs mit Microsoft Purview zum Senden und Empfangen von Atlas Kafka-Themennachrichten
In diesem Artikel erfahren Sie, wie Sie Microsoft Purview so konfigurieren, dass Atlas Kafka-Themenereignisse mit Azure Event Hubs gesendet und empfangen werden können.
Wenn Sie Ihre Umgebung bereits konfiguriert haben, können Sie unseren Leitfaden befolgen, um mit der .NET-Bibliothek Azure.Messaging.EventHubs zu beginnen, um Nachrichten zu senden und zu empfangen.
Voraussetzungen
Zum Konfigurieren Ihrer Umgebung müssen bestimmte Voraussetzungen erfüllt sein:
- Ein Microsoft Azure-Abonnement. Zur Verwendung von Azure-Diensten, einschließlich Event Hubs, benötigen Sie ein Azure-Abonnement. Wenn Sie nicht über ein Azure-Konto verfügen, können Sie sich für eine kostenlose Testversion registrieren oder Ihre MSDN-Abonnentenvorteile nutzen, wenn Sie ein Konto erstellen.
- Ein aktives Microsoft Purview-Konto.
Konfigurieren von Event Hubs
Zum Senden oder Empfangen von Atlas Kafka-Themennachrichten müssen Sie mindestens einen Event Hubs-Namespace konfigurieren. Sie können eine der folgenden Aktionen ausführen:
- Erstellen Sie Ihren eigenen Azure Event Hubs-Namespace, und konfigurieren Sie ihn für die Verwendung mit Microsoft Purview.
- Verwenden der REST-API zum Erstellen eines verwalteten Namespace
Hinweis
Wenn Ihr Microsoft Purview-Konto vor dem 15. Dezember 2022 erstellt wurde, ist Ihrem Konto möglicherweise bereits eine verwaltete Event Hubs-Ressource zugeordnet.
Sie können verwaltete Ressourcen unter einstellungen auf der Seite Ihres Microsoft Purview-Kontos im Azure-Portal einchecken.
Wenn diese Ressource nicht angezeigt wird oder deaktiviert ist, führen Sie die folgenden Schritte aus, um Ihre Event Hubs zu konfigurieren.
Wenn er aktiviert ist, können Sie diesen verwalteten Event Hubs-Namespace weiterhin verwenden, wenn Sie es bevorzugen. (Es fallen kostenassoziiert an. Weitere Informationen finden Sie auf der Preisseite.) Wenn Sie Ihr eigenes Event Hubs-Konto verwalten möchten, müssen Sie zunächst dieses Feature deaktivieren und die folgenden Schritte ausführen. Wenn Sie die verwaltete Event Hubs-Ressource deaktivieren, können Sie eine verwaltete Event Hub-Ressource nicht erneut aktivieren. Sie können nur Ihre eigenen Event Hubs konfigurieren..
Bring Your Own Event Hubs Namespace
Sie können einen vorhandenen Azure Event Hubs Namespace mit einem Event Hubs konfigurieren oder einen neuen erstellen, um eine Verbindung mit Microsoft Purview herzustellen.
Event Hubs-Berechtigungen
Für die Authentifizierung bei Ihren Event Hubs können Sie entweder Folgendes verwenden:
- Verwaltete Microsoft Purview-Identität (empfohlen)
- Vom Benutzer zugewiesene verwaltete Identität : Nur verfügbar, wenn Namespaces nach der Kontoerstellung konfiguriert werden und Event Hubs mit einem offenen Netzwerk verwendet werden.
Diese Identitäten benötigen mindestens Mitwirkender Berechtigungen für Ihre Event Hubs, um sie für die Verwendung mit Microsoft Purview konfigurieren zu können.
Event Hubs-Netzwerke
Wenn Ihr Microsoft Purview-Konto private Endpunkte verwendet, richten Sie einen privaten Erfassungsendpunkt ein, um eine Verbindung mit Event Hubs herzustellen.
Ihr Event Hubs-Arbeitsbereichsnetzwerk muss auf eine von zwei Arten konfiguriert werden:
- Öffentlicher Netzwerkzugriff auf Ausgewählte Netzwerke oder Deaktiviert festgelegt, Zulassen, dass vertrauenswürdige Microsoft-Dienste diese Firewall umgehen , auf Ja festgelegt, und verwenden Sie die verwaltete Microsoft Purview-Identität zur Authentifizierung.
- Der Öffentliche Netzwerkzugriff ist auf Alle Netzwerke festgelegt und verwendet die verwaltete Microsoft Purview-Identität oder eine benutzerseitig zugewiesene verwaltete Identität zur Authentifizierung.
Die status von Microsoft Purview als vertrauenswürdiger Dienst bedeutet, dass Ihre Hooks weiterhin Nachrichten von Event Hubs empfangen können, solange vertrauenswürdige Microsoft-Dienste diese Firewall umgehen auf Ja festgelegt ist.
Weitere Informationen zum Netzwerk für Event Hubs finden Sie in der Azure Event Hubs-Dokumentation.
Konfigurieren von Event Hubs zum Veröffentlichen von Nachrichten in Microsoft Purview
Navigieren Sie im Azure-Portal unter einstellungen auf der Seite Ihres Microsoft Purview-Kontos zu Kafka-Konfiguration.
Wählen Sie Konfiguration hinzufügen und Hookkonfiguration aus.
Hinweis
Sie können beliebig viele Hookkonfigurationen hinzufügen.
Geben Sie Ihrer Hookkonfiguration einen Namen, wählen Sie Ihr Abonnement, einen vorhandenen Event Hubs-Namespace, einen vorhandenen Event Hubs, an den die Benachrichtigungen gesendet werden sollen, die Consumergruppe, die Sie verwenden möchten, und die Art der Authentifizierung aus, die Sie verwenden möchten.
Tipp
Sie können denselben Event Hubs-Namespace mehrmals verwenden, aber jede Konfiguration benötigt eigene Event Hubs.
Klicken Sie auf Speichern. Es dauert einige Minuten, bis Ihre Konfiguration abgeschlossen ist.
Sobald die Konfiguration abgeschlossen ist, können Sie mit den Schritten zum Veröffentlichen von Nachrichten in Microsoft Purview beginnen.
Konfigurieren von Event Hubs für den Empfang von Nachrichten von Microsoft Purview
Navigieren Sie im Azure-Portal unter einstellungen auf der Seite Ihres Microsoft Purview-Kontos zu Kafka-Konfiguration.
Wenn bereits eine Konfiguration als Benachrichtigungstyp aufgeführt ist, ist Event Hubs bereits konfiguriert, und Sie können mit den Schritten zum Empfangen von Microsoft Purview-Nachrichten beginnen.
Hinweis
Es kann jeweils nur ein Notification Event Hub konfiguriert werden.
Wenn noch keine Benachrichtigungskonfiguration aufgeführt ist, wählen Sie Konfiguration hinzufügen und Benachrichtigungskonfiguration aus.
Geben Sie Ihrer Benachrichtigungskonfiguration einen Namen, wählen Sie Ihr Abonnement, einen vorhandenen Event Hubs-Namespace, einen vorhandenen Event Hubs, an den die Benachrichtigungen gesendet werden sollen, die Partitionen, die Sie verwenden möchten, und die Art der Authentifizierung aus, die Sie verwenden möchten.
Tipp
Sie können denselben Event Hubs-Namespace mehrmals verwenden, aber jede Konfiguration benötigt eigene Event Hubs.
Klicken Sie auf Speichern. Es dauert einige Minuten, bis Ihre Konfiguration abgeschlossen ist.
Sobald die Konfiguration abgeschlossen ist, können Sie mit den Schritten zum Empfangen von Microsoft Purview-Nachrichten beginnen.
Entfernen konfigurierter Event Hubs
Um konfigurierte Event Hubs-Namespaces zu entfernen, können Sie die folgenden Schritte ausführen:
Suchen Sie im Azure-Portal nach Ihrem Microsoft Purview-Konto, und öffnen Sie es.
Wählen Sie kafka-Konfiguration unter Einstellungen auf der Seite Ihres Microsoft Purview-Kontos im Azure-Portal aus.
Wählen Sie die Event Hubs aus, die Sie deaktivieren möchten. (Hookhubs senden Nachrichten an Microsoft Purview. Notification Hubs empfangen Benachrichtigungen.)
Wählen Sie Entfernen aus, um die Auswahl zu speichern und den Deaktivierungsprozess zu starten. Dies kann einige Minuten dauern.
Erstellen eines verwalteten Namespace
Wenn Sie einen verwalteten Event Hubs-Namespace bevorzugen, müssen Sie zum Konfigurieren Ihres Kontos die REST-API verwenden.
Sie können das folgende Skript (set apiVersion = 2021-12-01) verwenden, um ein Konto zu aktualisieren. Dies wirkt sich nur auf die Event Hub-Konfiguration aus:
$body = @{"properties" = @{ "managedEventHubState" = "Enabled" }; "location" = $($location); "identity" = @{ "type"= $($type) } } | ConvertTo-Json
$Token=Get-AzAccessToken
$Headers = @{ "Authorization" = "Bearer $($Token.Token)" }
$Uri = "https://management.azure.com/subscriptions/$($subscription)/resourceGroups/$($rg)/providers/Microsoft.Purview/accounts/$($accountName)?api-version=$($apiVersion)"
Invoke-WebRequest -URI $Uri -Method Put -Body $body -Headers $Headers -ContentType "application/json"