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 Event Grid-Erfassung erforderlichen Ressourcen manuell erstellen: ein Event Grid-Abonnement, einen Event Hubs-Namespace und einen Event Hub. Die Erstellung von Event Hubs-Namespaces und Event Hubs werden unter 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.
• Ein Azure Data Explorer-Cluster und eine Datenbank Erstellen eines Clusters und einer Datenbank
• Ein Speicherkonto. Ein Event Grid-Benachrichtigungsabonnement kann für Azure Storage-Konten für BlobStorage, StorageV2oder Data Lake Storage Gen2 festgelegt werden.
• Ein Event Hubs-Namespace und 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ü die Option 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 die Option Event Hubs aus.

   

5. Klicken Sie auf Endpunkt auswählen, und fügen Sie den von Ihnen erstellten Event Hub ein, z. B. test-hub.

6. 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 von 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 Verarbeitungsfehler und Fehler bei der Dateierfassung 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
   Betreiber	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.

7. Klicken Sie auf Erstellen

Nächster Schritt

Erstellen einer Event Grid-Datenverbindung