Manuelles Erstellen von Ressourcen für die Event Grid-Erfassung

• Portal
• Portal: Manuelles Erstellen von Ressourcen
• C#
• Python
• Azure Resource Manager-Vorlage

Azure Data Explorer ermöglicht die kontinuierliche Erfassung aus Azure Storage (Azure Blob Storage und Azure Data Lake Storage Gen2) über eine Event Grid-Erfassungspipeline. In der Event Grid-Erfassungspipeline werden von einem Azure Event Grid-Dienst Ereignisse zur Erstellung oder Umbenennung von Blobs aus einem Speicherkonto über Azure Event Hubs an Azure Data Explorer weitergeleitet.

In diesem Artikel erfahren Sie, wie Sie die für die Ereignisrasteraufnahme erforderlichen Ressourcen manuell erstellen: ein Event Grid-Abonnement, einen Event Hubs-Namespace und einen Event Hub. Der Event Hubs-Namespace und die Erstellung von Event Hubs werden in den Voraussetzungen beschrieben. Informationen zur Verwendung der automatischen Erstellung dieser Ressourcen beim Definieren der Event Grid-Erfassung finden Sie unter Erstellen einer Event Grid-Datenverbindung in Azure Data Explorer.

Voraussetzungen

• Ein Azure-Abonnement. Erstellen Sie ein kostenloses Azure-Konto.
• Schnellstart: Erstellen eines Azure Data Explorer-Clusters und einer Datenbank. Erstellen eines Clusters und einer Datenbank
• Ein Speicherkonto. Ein Abonnement von Event Grid-Benachrichtigungen kann in Azure Storage-Konten für BlobStorage, StorageV2 oder Data Lake Storage Gen2 festgelegt werden.
• Ein Event Hubs-Namespace und ein Event Hub.

Hinweis

Die beste Leistung erzielen Sie, wenn Sie alle Ressourcen in der gleichen Region wie den Azure Data Explorer-Cluster erstellen.

Erstellen eines Event Grid-Abonnements

1. Wechseln Sie im Azure-Portal zu Ihrem Speicherkonto.

2. Wählen Sie im linken Menü " Ereignisse>+ Ereignisabonnement" aus.

   

3. Geben Sie im Fenster Ereignisabonnement erstellen auf der Registerkarte Einfach die folgenden Werte an:

   

   Einstellung	Empfohlener Wert	Feldbeschreibung
   Name	test-grid-connection	Der Name des Event Grid-Abonnements, das Sie erstellen möchten.
   Ereignisschema	Event Grid-Schema	Das gewünschte Schema für die Event Grid-Instanz.
   Thementyp	Speicherkonto	Der Typ des Event Grid-Themas. Wird automatisch eingefügt.
   Quellressource	gridteststorage1	Der Name Ihres Speicherkontos. Wird automatisch eingefügt.
   Name des Systemthemas	gridteststorage1...	Das Systemthema, unter dem Ereignisse von Azure Storage veröffentlicht werden. Von diesem Systemthema wird das Ereignis dann an einen Abonnenten weitergeleitet, der Ereignisse empfängt und verarbeitet. Wird automatisch eingefügt.
   Nach Ereignistypen filtern	Blob erstellt	Gibt an, bei welchen spezifischen Ereignissen eine Benachrichtigung erfolgen soll. Wählen Sie beim Erstellen des Abonnements einen der unterstützten Typen aus: Microsoft.Storage.BlobCreated oder Microsoft.Storage.BlobRenamed. Das Umbenennen von Blobs wird nur für ADLSv2-Speicher unterstützt.

4. Wählen Sie unter ENDPUNKTDETAILS "Event Hubs" aus.

   

5. Wählen Sie einen Endpunkt aus, und füllen Sie den von Ihnen erstellten Event Hub aus, z. B . test-hub.

6. Wählen Sie unter MANAGED IDENTITY FOR DELIVERY optional einen verwalteten Identitätstyp mithilfe der Informationen in der folgenden Tabelle aus.

   

   Typ	Beschreibung
   Keine (Standard)	Ereignisse werden nicht mithilfe von verwalteten Identitäten übermittelt.
   Vom System zugewiesen	Ereignisse werden mithilfe einer vom System zugewiesenen verwalteten Identität übermittelt. WICHTIG: Bevor Sie diese Option verwenden, stellen Sie sicher, dass Sie die vom System zugewiesene Systemidentität im Thema "Event Grid" aktiviert haben und ihm die Rolle "Azure Event Hubs Data Sender " auf dem Event Hub zugewiesen haben. Weitere Informationen finden Sie unter Aktivieren einer verwalteten Identität für Systemthemen.

   Wichtig

   Wenn Sie die lokale Authentifizierung im Event Hubs-Namespace deaktivieren, der den event hub enthält, der für Streamingbenachrichtigungen verwendet wird, müssen Sie verwaltete Identitäten verwenden, um Ereignisse bereitzustellen, wenn Sie dieses Ereignisabonnement verwenden.

7. Wählen Sie die Registerkarte Filter aus, wenn Sie Ereignisse filtern möchten.

   Verwenden Sie Betrefffilter, um bestimmte Themenereignisse nachzuverfolgen. Legen Sie die Filter für die Benachrichtigungen wie folgt fest:

   

   1. Wählen Sie Betrefffilter aktivieren aus.
   2. Das Feld Betreff beginnt mit ist das Literalpräfix des Themas (Betreffs). Da das angewendete Muster startswith ist, kann es mehrere Container, Ordner oder Blobs umfassen. Platzhalter sind nicht zulässig.
      • Zum Definieren eines Filters für den Blobcontainer legen Sie das Feld wie folgt fest: /blobServices/default/containers/[container prefix].
      • Zum Definieren eines Filters für ein Blobpräfix (oder einen Ordner in Azure Data Lake Gen2) legen Sie das Feld wie folgt fest: /blobServices/default/containers/[container name]/blobs/[folder/blob prefix].
   3. Das Feld Betreff endet auf ist das literale Suffix des Blobs. Platzhalter sind nicht zulässig.
   4. Mit dem Feld Betreffabgleich mit Beachtung der Groß-/Kleinschreibung wird angegeben, ob bei den Präfix- und Suffixfiltern nach Groß-/Kleinschreibung unterschieden wird.

   Weitere Informationen zum Filtern von Ereignissen finden Sie unter Blob Storage-Ereignisse.

   Verwenden Sie Erweiterte Filter, um benutzerdefinierte Filter hinzuzufügen, die Ihren Anforderungen entsprechen.

   Wenn Sie beispielsweise das Azure Data Lake SDK zum Hochladen einer Datei verwenden, löst die Dateierstellung ein Event Grid-Ereignis mit der Größe 0 aus. Dieses Ereignis wird vom Azure Data Explorer verworfen. Durch den Dateileerungsvorgang wird ein anderes Ereignis ausgelöst, wenn der Parameter Close auf true festgelegt ist. Dieses Ereignis gibt an, dass dies das endgültige Update ist und der Dateistream geschlossen wurde. Um unnötige Verarbeitungs- und leere Dateiaufnahmefehler zu vermeiden, filtern Sie CreateFile-Ereignisse mithilfe des folgenden Filters heraus:

   

   Einstellung	Empfohlener Wert	Feldbeschreibung
   Schlüssel	data.api	Das Feld im Ereignisschema, das zum Filtern verwendet wird
   Operator	Die Zeichenfolge ist nicht in	Ein Operator, der für den ausgewählten Schlüssel ausgewertet werden soll.
   Wert	CreateFile	Der Wert, der zum Auswerten des Schlüssels verwendet wird.

8. Klicken Sie auf Erstellen

Nächster Schritt

Erstellen einer Event Grid-Datenverbindung