Skapa en IoT Hub dataanslutning för Azure Data Explorer

Den här artikeln visar hur du matar in data i Azure Data Explorer från IoT Hub, en plattform för stordataströmning och IoT-inmatningstjänsten.

Information om hur du skapar anslutningen i Azure Portal eller med en ARM-mall finns i Skapa en IoT-dataanslutning.

Allmän information om hur du matar in i Azure Data Explorer från IoT Hub finns i Ansluta till IoT Hub.

Anteckning

Endast händelser som anges när du har skapat dataanslutningen matas in.

Kodexempel som baseras på tidigare SDK-versioner finns i den arkiverade artikeln.

Förutsättningar

• En Azure-prenumeration. Skapa ett kostnadsfritt Azure-konto.
• Ett Azure Data Explorer-kluster och en databas. Skapa ett kluster och en databas.
• En måltabell. Skapa en tabell eller använd en befintlig tabell.
• En inmatningsmappning för tabellen.
• En IoT Hub med data för inmatning.

Skapa en IoT Hub dataanslutning

I det här avsnittet upprättar du en anslutning mellan IoT Hub och din Azure Data Explorer-tabell. Så länge anslutningen är på plats överförs data från IoT Hub till måltabellen.

Portal

1. I den vänstra menyn i Azure Data Explorer-klustret väljer du Databaser och sedan den databas som innehåller måltabellen.

   

2. Välj Dataanslutningar och Lägg till dataanslutning. I listrutan väljer du IoT Hub.

   

3. Fyll i formuläret med följande information.

   Inställning	Fältbeskrivning
   Namn på dataanslutning	Namnet på den anslutning som du vill skapa i Azure Data Explorer
   Prenumeration	Prenumerations-ID:t där Event Hubs-resursen finns.
   IoT Hub	IoT Hub namn
   Princip för delad åtkomst	Namnet på principen för delad åtkomst. Måste ha läsbehörighet
   Konsumentgrupp	Konsumentgruppen som definierats i den IoT Hub inbyggda slutpunkten
   Egenskaper för händelsesystem	Egenskaperna för IoT Hub händelsesystem. När du lägger till systemegenskaper skapar eller uppdaterar du tabellschema och mappning så att de valda egenskaperna inkluderas.

   

   Anteckning

   • Händelsesystemegenskaper stöds för händelser med en post.
   • För CSV-mappning läggs egenskaper till i början av posten. För JSON-mappning läggs egenskaper till enligt namnet som visas i listrutan.

4. Beroende på ditt användningsfall kanske du vill aktivera routning för flera databaser. Mer information om databasroutning finns i Händelseroutning.

   

5. Fyll i följande routningsinställningar:

   Inställning	Föreslaget värde	Fältbeskrivning
   Tabellnamn	TestTable	Tabellen som du skapade i testdb.
   Dataformat	JSON	Format som stöds är AVRO, CSV, JSON, ORC, PARQUET, PSV, SCSV, SOHSV, TSV, TXT, TSVE, APACHE AVRO och W3CLOG.
   Mappning	TestMapping	Mappningen som du skapade i testdb, som mappar inkommande data till kolumnnamnen och datatyperna för testdb. Om inget anges används en identitetsdatamappning som härletts från tabellens schema.

   

   Anteckning

   • JSON-data parsas som multijson som standard. Välj Ignorera formatfel för att mata in data i strikt JSON-format.
   • Om du har valt Egenskaper för händelsesystem måste du inkludera systemegenskaper i tabellschemat och mappningen.

6. Välj Skapa.

Varning

Vid manuell redundans återskapar du dataanslutningen.

ARM-mall

I följande exempel visas en Azure Resource Manager-mall för att lägga till en IoT Hub dataanslutning. Du kan redigera och distribuera mallen i Azure Portal med hjälp av formuläret .

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

Ta bort en IoT Hub dataanslutning

Gör följande för att ta bort IoT Hub-anslutningen från Azure Portal:

1. Gå till klustret. Välj Databaser på den vänstra menyn. Välj sedan den databas som innehåller måltabellen.
2. Välj Dataanslutningar på den vänstra menyn. Markera sedan kryssrutan bredvid relevant IoT Hub dataanslutning.
3. Välj Ta bort på den översta menyraden.

---

Relaterat innehåll

• Fråga efter data i Azure Data Explorer-webbgränssnittet