Freigeben über

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

  • Artikel

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

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.

    Screenshot der Seite

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

    Screenshot der Seite

    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.

    Wählen Sie einen Ereignishandler aus, um Ihre Ereignisse – Event Hub – Azure Data Explorer zu empfangen.

  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.

    Screenshot des Abschnitts

    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 der 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:

    Screenshot der Registerkarte

    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:

    Screenshot, der zeigt, wie Sie Dateiereignisse herausfiltern.

    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 Ereignisrasterdatenverbindung