Vytvoření datového připojení ioT Hubu pro Azure Data Explorer

Tento článek ukazuje, jak ingestovat data do Azure Data Exploreru ze služby IoT Hub, platformy pro streamování velkých objemů dat a služby pro příjem dat IoT.

Informace o vytvoření připojení na webu 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 Exploreru ze služby IoT Hub najdete v tématu Připojení ke službě IoT Hub.

Poznámka:

Po vytvoření datového připojení se ingestují pouze události, které se zařadí do fronty.

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 bezplatný účet Azure.
• Cluster a databáze Azure Data Exploreru. 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 Hubu

V této části vytvoříte propojení mezi IoT Hubem a tabulkou Azure Data Exploreru. Pokud je toto připojení na místě, data se přenášejí z IoT Hubu do cílové tabulky.

Azure Portal

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

   

2. Vyberte Datová připojení a Přidejte 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 Exploreru
   Předplatné	ID předplatného, ve kterém se nachází prostředek služby Event Hubs.
   IoT Hub	Název centra 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 integrovaném koncovém bodu Služby IoT Hub
   Vlastnosti systému událostí	Vlastnosti systému událostí služby 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:

   • U událostí s jedním záznamem jsou podporovány vlastnosti systému událostí.
   • Pro mapování sdíleného svazku clusteru se na začátek záznamu přidají vlastnosti. U 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 naleznete 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 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í, které jste vytvořili v 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:

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

6. Vyberte Vytvořit.

Upozorňující

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 Manageru pro přidání datového připojení ioT Hubu. Šablonu můžete upravit a nasadit na webu 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 Hubu

Pokud chcete připojení ioT Hubu odebrat z webu Azure Portal, 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 datového připojení IoT Hubu.
3. V horním řádku nabídek vyberte Odstranit.

---

Související obsah

• Dotazování dat ve webovém uživatelském rozhraní Azure Data Exploreru