Erstellen einer IoT Hub-Datenverbindung für Azure Data Explorer

In diesem Artikel wird erläutert, wie Sie in Azure Data Explorer Daten aus IoT Hub (Big Data-Streamingplattform und IoT-Erfassungsdienst) erfassen.

Informationen zum Erstellen der Verbindung im Azure-Portal oder mit einer ARM-Vorlage finden Sie unter Erstellen einer IoT-Datenverbindung.

Allgemeine Informationen zur Erfassung in Azure Data Explorer aus IoT Hub finden Sie unter Herstellen einer Verbindung mit IoT Hub.

Hinweis

Nur Ereignisse, die nach dem Erstellen der Datenverbindung in die Warteschlange eingereiht werden, werden erfasst.

Codebeispiele, die auf früheren SDK-Versionen basieren, finden Sie im archivierten Artikel.

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
• Eine Zieltabelle: Erstellen Sie eine Tabelle, oder verwenden Sie eine vorhandene.
• Eine Erfassungszuordnung für die Tabelle.
• Ein IoT Hub mit Daten für die Erfassung.

Erstellen einer IoT Hub-Datenverbindung

In diesem Abschnitt richten Sie eine Verbindung zwischen dem IoT Hub und Ihrer Azure Data Explorer-Tabelle ein. Solange diese Verbindung vorhanden ist, werden Daten vom IoT Hub in Ihre Zieltabelle übertragen.

Portal

1. Wählen Sie im linken Menü Ihres Azure Data Explorer-Clusters Datenbanken aus, und wählen Sie dann die Datenbank aus, die Ihre Zieltabelle enthält.

   

2. Wählen Sie Datenverbindungen und dann Datenverbindung hinzufügen aus. Wählen Sie im Dropdownmenü "IoT Hub" aus.

   

3. Füllen Sie das Formular mit den folgenden Informationen aus.

   Einstellung	Feldbeschreibung
   Name der Datenverbindung	Der Name der Verbindung, die Sie in Azure Data Explorer erstellen möchten.
   Abonnement	Die Abonnement-ID, unter der sich die Event Hubs-Ressource befindet
   IoT Hub	IoT Hub-Name
   SAS-Richtlinie	Der Name der SAS-Richtlinie. Leseberechtigungen erforderlich
   Consumergruppe	Die Consumergruppe, die im integrierten IoT Hub-Endpunkt definiert ist.
   Ereignissystemeigenschaften	Die IoT Hub-Ereignissystemeigenschaften. Beim Hinzufügen von Systemeigenschaften erstellen oder aktualisieren Sie das Tabellenschema und die Zuordnung, um die ausgewählten Eigenschaften einzubeziehen.

   

   Hinweis

   • Ereignissystemeigenschaften werden für Einzeldatensatzereignisse unterstützt.
   • Für die CSV-Zuordnung werden Eigenschaften am Anfang des Datensatzes hinzugefügt. Für die JSON-Zuordnung werden Eigenschaften entsprechend dem Namen hinzugefügt, der in der Dropdownliste angezeigt wird.

4. Je nach Anwendungsfall sollten Sie das Routing mit mehreren Datenbanken aktivieren. Weitere Informationen zum Datenbankrouting finden Sie unter Ereignisrouting.

   

5. Füllen Sie die folgenden Routingeinstellungen aus:

   Einstellung	Empfohlener Wert	Feldbeschreibung
   Tabellenname	TestTable	Die Tabelle, die Sie in testdb erstellt haben.
   Datenformat	JSON	Unterstützte Formate sind AVRO, CSV, JSON, ORC, PARTS, PSV, SCSV, SOHSV, TSV, TXT, TSVE, APACHE AVRO und W3CLOG.
   Zuordnung	TestMapping	Die Zuordnung, die Sie in testdb erstellt haben, um eingehende Daten den Spaltennamen und Datentypen von testdb zuzuordnen. Wenn nicht angegeben, wird eine identitätsdatenzuordnung, die aus dem Schema der Tabelle abgeleitet ist, verwendet.

   

   Hinweis

   • JSON-Daten werden standardmäßig als Multijson analysiert. Wählen Sie "Formatfehler ignorieren" aus, um die Daten im strengen JSON-Format aufzunehmen.
   • Wenn Sie ereignissystemeigenschaften ausgewählt haben, müssen Sie Systemeigenschaften in das Tabellenschema und die Zuordnung einschließen.

6. Klicken Sie auf Erstellen.

Warnung

Erstellen Sie bei einem manuellen Failover die Datenverbindung neu.

ARM-Vorlage

Das folgende Beispiel zeigt eine Azure Resource Manager-Vorlage für das Hinzufügen einer IoT Hub-Datenverbindung. Sie können die Vorlage im Azure-Portal mithilfe des Formulars bearbeiten und bereitstellen.

{
    "$schema": "https://schema.management.azure.com/schemas/2015-01-01/deploymentTemplate.json#",
    "contentVersion": "1.0.0.0",
    "parameters": {
        "IotHubs_iothubdemo_name": {
            "type": "string",
            "defaultValue": "iothubdemo",
            "metadata": {
                "description": "Specifies the IoT Hub name."
            }
        },
        "iothubpolices_iothubowner_name": {
            "type": "string",
            "defaultValue": "iothubowner",
            "metadata": {
                "description": "Specifies the shared access policy name."
            }
        },
        "consumergroup_default_name": {
            "type": "string",
            "defaultValue": "$Default",
            "metadata": {
                "description": "Specifies the consumer group of the IoT Hub."
            }
        },
        "Clusters_kustocluster_name": {
            "type": "string",
            "defaultValue": "kustocluster",
            "metadata": {
                "description": "Specifies the name of the cluster"
            }
        },
        "databases_kustodb_name": {
            "type": "string",
            "defaultValue": "kustodb",
            "metadata": {
                "description": "Specifies the name of the database"
            }
        },
        "tables_kustotable_name": {
            "type": "string",
            "defaultValue": "kustotable",
            "metadata": {
                "description": "Specifies the name of the table"
            }
        },
        "mapping_kustomapping_name": {
            "type": "string",
            "defaultValue": "kustomapping",
            "metadata": {
                "description": "Specifies the name of the mapping rule"
            }
        },
        "dataformat_type": {
            "type": "string",
            "defaultValue": "csv",
            "metadata": {
                "description": "Specifies the data format"
            }
        },
           "databaseRouting_type": {
            "type": "string",
            "defaultValue": "Single",
            "metadata": {
                "description": "The database routing for the connection. If you set the value to **Single**, the data connection will be routed to a single database in the cluster as specified in the *databaseName* setting. If you set the value to **Multi**, you can override the default target database using the *Database* EventData property."
            }
        },
        "dataconnections_kustodc_name": {
            "type": "string",
            "defaultValue": "kustodc",
            "metadata": {
                "description": "Name of the data connection to create"
            }
        },
        "subscriptionId": {
            "type": "string",
            "defaultValue": "[subscription().subscriptionId]",
            "metadata": {
                "description": "Specifies the subscriptionId of the IoT Hub"
            }
        },
        "resourceGroup": {
            "type": "string",
            "defaultValue": "[resourceGroup().name]",
            "metadata": {
                "description": "Specifies the resourceGroup of the IoT Hub"
            }
        },
        "location": {
            "type": "string",
            "defaultValue": "[resourceGroup().location]",
            "metadata": {
                "description": "Location for all resources."
            }
        }
    },
    "variables": {
    },
    "resources": [{
            "type": "Microsoft.Kusto/Clusters/Databases/DataConnections",
            "apiVersion": "2019-09-07",
            "name": "[concat(parameters('Clusters_kustocluster_name'), '/', parameters('databases_kustodb_name'), '/', parameters('dataconnections_kustodc_name'))]",
            "location": "[parameters('location')]",
            "kind": "IotHub",
            "properties": {
                "iotHubResourceId": "[resourceId(parameters('subscriptionId'), parameters('resourceGroup'), 'Microsoft.Devices/IotHubs', parameters('IotHubs_iothubdemo_name'))]",
                "consumerGroup": "[parameters('consumergroup_default_name')]",
                "sharedAccessPolicyName": "[parameters('iothubpolices_iothubowner_name')]",
                "tableName": "[parameters('tables_kustotable_name')]",
                "mappingRuleName": "[parameters('mapping_kustomapping_name')]",
                "dataFormat": "[parameters('dataformat_type')]",
                 "databaseRouting": "[parameters('databaseRouting_type')]"
            }
        }
    ]
}

Entfernen einer IoT Hub-Datenverbindung

Gehen Sie wie folgt vor, um die IoT Hub-Verbindung aus dem Azure-Portal zu entfernen:

1. Zum Custer wechseln Wählen Sie im linken Menü Einstellungen aus. Wählen Sie dann die Datenbank aus, die die Zieltabelle enthält.
2. Wählen Sie im linken Menü Datenverbindungen aus. Aktivieren Sie dann das Kontrollkästchen neben der relevanten IoT Hub-Datenverbindung.
3. Wählen Sie in der oberen Menüleiste Löschen aus.

---

Zugehöriger Inhalt

• Abfragen von Daten auf der Azure Data Explorer-Webbenutzeroberfläche