Vytvoření datového připojení IoT Hub pro Azure Data Explorer

V tomto článku se dozvíte, jak ingestovat data do Azure Data Explorer z IoT Hub, což je platforma pro streamování velkých objemů dat a služba pro příjem dat IoT.

Informace o vytvoření připojení v Azure Portal nebo pomocí šablony ARM najdete v tématu Vytvoření datového připojení IoT.

Obecné informace o ingestování do Azure Data Explorer z IoT Hub najdete v tématu Připojení k IoT Hub.

Poznámka

Ingestují se pouze události, které jsou zařaděné do fronty po vytvoření datového připojení.

Ukázky kódu založené na předchozích verzích sady SDK najdete v archivovaného článku.

Požadavky

• Předplatné Azure. Vytvořte si bezplatný účet Azure.
• Cluster a databáze Azure Data Explorer. Vytvořte cluster a databázi.
• Cílová tabulka. Vytvořte tabulku nebo použijte existující tabulku.
• Mapování příjmu dat pro tabulku
• IoT Hub s daty pro příjem dat.

Vytvoření datového připojení IoT Hub

V této části navážete spojení mezi IoT Hub a tabulkou Azure Data Explorer. Dokud je toto připojení na místě, data se přenášejí z IoT Hub do cílové tabulky.

Azure Portal

1. V levé nabídce clusteru Azure Data Explorer vyberte Databáze a pak vyberte databázi, která obsahuje cílovou tabulku.

   

2. Vyberte Datová připojení a Přidat datové připojení. V rozevíracím seznamu vyberte IoT Hub.

   

3. Do formuláře zadejte následující informace.

   Nastavení	Popis pole
   Název datového připojení	Název připojení, které chcete vytvořit v Azure Data Explorer
   Předplatné	ID předplatného, ve kterém se nachází prostředek služby Event Hubs.
   IoT Hub	název IoT Hub
   Zásady sdíleného přístupu	Název zásady sdíleného přístupu. Musí mít oprávnění ke čtení.
   Skupina uživatelů	Skupina příjemců definovaná v IoT Hub integrovaném koncovém bodu
   Vlastnosti systému událostí	Vlastnosti systému událostí IoT Hub. Při přidávání systémových vlastností vytvořte nebo aktualizujte schéma tabulky a mapování tak, aby zahrnovalo vybrané vlastnosti.

   

   Poznámka

   • Vlastnosti systému událostí jsou podporovány pro události s jedním záznamem.
   • Pro mapování CSV se vlastnosti přidají na začátek záznamu. Pro mapování JSON se vlastnosti přidají podle názvu, který se zobrazí v rozevíracím seznamu.

4. V závislosti na vašem případu použití můžete chtít zapnout směrování s více databázemi. Další informace o směrování databáze najdete v tématu Směrování událostí.

   

5. Vyplňte následující nastavení směrování:

   Nastavení	Navrhovaná hodnota	Popis pole
   Název tabulky	TestTable	Tabulka, kterou jste vytvořili v databázi testdb.
   Formát dat	JSON	Podporované formáty jsou AVRO, CSV, JSON, ORC, PARQUET, PSV, SCSV, SOHSV, TSV, TXT, TSVE, APACHE AVRO a W3CLOG.
   Mapování	TestMapping	Mapování vytvořené v databázi testdb, které mapuje příchozí data na názvy sloupců a datové typy testdb. Pokud není zadáno, použije se mapování dat identity odvozené ze schématu tabulky.

   

   Poznámka

   • Data JSON se ve výchozím nastavení parsují jako multijson. Pokud chcete ingestovat data v striktním formátu JSON, vyberte Ignorovat chyby formátu .
   • Pokud jste vybrali Vlastnosti systému událostí, musíte do schématu tabulky a mapování zahrnout systémové vlastnosti .

6. Vyberte Vytvořit.

Upozornění

V případě ručního převzetí služeb při selhání vytvořte datové připojení znovu.

Šablona ARM

Následující příklad ukazuje šablonu Azure Resource Manager pro přidání datového připojení IoT Hub. Šablonu můžete upravit a nasadit v Azure Portal pomocí formuláře.

{
    "$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')]"
            }
        }
    ]
}

Odebrání datového připojení IoT Hub

Pokud chcete připojení IoT Hub z Azure Portal odebrat, postupujte takto:

1. Přejděte do clusteru. V nabídce vlevo vyberte Databáze. Pak vyberte databázi, která obsahuje cílovou tabulku.
2. V nabídce vlevo vyberte Datová připojení. Pak zaškrtněte políčko vedle příslušného IoT Hub datového připojení.
3. V horním řádku nabídek vyberte Odstranit.

---

Související obsah

• Dotazování na data ve webovém uživatelském rozhraní Azure Data Explorer