Konfigurieren von Event Hubs mit Microsoft Purview zum Senden und Empfangen von Atlas Kafka-Themennachrichten

Artikel
10/06/2023

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. Screenshot: Hervorgehobener Event Hubs-Namespace-Umschalter auf der Seite

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 Namespace (Bring Your Own 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.

Wichtig

Derzeit können Event Hubs, die private Endpunkte verwenden, nicht mit Microsoft Purview für Atlas Kafka-Themennachrichten konfiguriert werden. Wenn Sie einen privaten Endpunkt benötigen, verwenden Sie einen verwalteten Namespace.

Event Hubs-Berechtigungen

Für die Authentifizierung bei Ihren Event Hubs können Sie entweder Folgendes verwenden:

Verwaltete Microsoft Purview-Identität
Benutzerseitig zugewiesene verwaltete Identität – nur verfügbar, wenn Namespaces nach der Kontoerstellung konfiguriert werden.

Eine dieser Identitäten benötigt mindestens Mitwirkender Berechtigungen für Ihre Event Hubs, um sie für die Verwendung mit Microsoft Purview konfigurieren zu können.

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.
Wählen Sie Speichern aus. 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.
Wählen Sie Speichern aus. 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 ihren Event Hubs-Namespace für die Verbindung über einen privaten Endpunkt benötigen oder 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"

Teilen über