Een IoT Hub-gegevensverbinding maken voor Azure Data Explorer

In dit artikel wordt beschreven hoe u gegevens opneemt in Azure Data Explorer vanuit IoT Hub, een platform voor het streamen van big data en een IoT-opnameservice.

Zie Een IoT-gegevensverbinding maken voor meer informatie over het maken van de verbinding in de Azure Portal of met een ARM-sjabloon.

Zie Verbinding maken met IoT Hub voor algemene informatie over opname in Azure Data Explorer vanuit IoT Hub.

Notitie

Alleen gebeurtenissen die zijn opgenomen nadat u de gegevensverbinding hebt gemaakt, worden opgenomen.

Zie het gearchiveerde artikel voor codevoorbeelden op basis van eerdere SDK-versies.

Vereisten

• Een Azure-abonnement. Maak een gratis Azure-account.
• Een Azure Data Explorer-cluster en -database. Maak een cluster en database.
• Een doeltabel. Maak een tabel of gebruik een bestaande tabel.
• Een opnametoewijzing voor de tabel.
• Een IoT Hub met gegevens voor opname.

Een IoT Hub-gegevensverbinding maken

In deze sectie brengt u een verbinding tot stand tussen de IoT Hub en uw Azure Data Explorer-tabel. Zolang deze verbinding tot stand is gebracht, worden gegevens van de IoT Hub verzonden naar uw doeltabel.

Portal

1. Selecteer databases in het linkermenu van uw Azure Data Explorer-cluster en selecteer vervolgens de database die uw doeltabel bevat.

   

2. Selecteer Gegevensverbindingen en Gegevensverbinding toevoegen. Selecteer IoT Hub in de vervolgkeuzelijst.

   

3. Vul in het formulier de volgende gegevens in.

   Instelling	Beschrijving van veld
   Naam van gegevensverbinding	De naam van de verbinding die u wilt maken in Azure Data Explorer
   Abonnement	De abonnements-id waar de Event Hubs-resource zich bevindt.
   IoT Hub	IoT Hub naam
   Beleid voor gedeelde toegang	De naam van het beleid voor gedeelde toegang. Moet leesmachtigingen hebben
   Consumentengroep	De consumentengroep die is gedefinieerd in het ingebouwde eindpunt van de IoT Hub
   Eigenschappen van gebeurtenissysteem	De IoT Hub gebeurtenissysteemeigenschappen. Wanneer u systeemeigenschappen toevoegt, maakt of werkt u het tabelschema en de toewijzing bij om de geselecteerde eigenschappen op te nemen.

   

   Notitie

   • Eigenschappen van gebeurtenissysteem worden ondersteund voor gebeurtenissen met één record.
   • Voor CSV-toewijzing worden eigenschappen toegevoegd aan het begin van de record. Voor JSON-toewijzing worden eigenschappen toegevoegd op basis van de naam die in de vervolgkeuzelijst wordt weergegeven.

4. Afhankelijk van uw gebruiksscenario kunt u routering voor meerdere databases inschakelen. Zie Gebeurtenisroutering voor meer informatie over databaseroutering.

   

5. Vul de volgende routeringsinstellingen in:

   Instelling	Voorgestelde waarde	Beschrijving van veld
   Tabelnaam	TestTable	De tabel die u hebt gemaakt in testdb.
   Gegevensindeling	JSON	Ondersteunde indelingen zijn AVRO, CSV, JSON, ORC, PARQUET, PSV, SCSV, SOHSV, TSV, TXT, TSVE, APACHE AVRO en W3CLOG.
   Toewijzing	TestMapping	De toewijzing die u hebt gemaakt in testdb, waarmee binnenkomende gegevens worden toegewezen aan de kolomnamen en gegevenstypen van testdb. Als dit niet is opgegeven, wordt een toewijzing van identiteitsgegevens gebruikt die is afgeleid van het schema van de tabel.

   

   Notitie

   • JSON-gegevens worden standaard geparseerd als multijson. Selecteer Indelingsfouten negeren om de gegevens op te nemen in strikte JSON-indeling.
   • Als u Gebeurtenissysteemeigenschappen hebt geselecteerd, moet u systeemeigenschappen opnemen in het tabelschema en de toewijzing.

6. Selecteer Maken.

Waarschuwing

In het geval van een handmatige failover maakt u de gegevensverbinding opnieuw.

ARM-sjabloon

In het volgende voorbeeld ziet u een Azure Resource Manager-sjabloon voor het toevoegen van een IoT Hub-gegevensverbinding. U kunt de sjabloon in de Azure Portal bewerken en implementeren met behulp van het formulier.

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

Een IoT Hub-gegevensverbinding verwijderen

Ga als volgt te werk om de IoT Hub verbinding uit de Azure Portal te verwijderen:

1. Ga naar uw cluster. Selecteer Databases in het menu links. Selecteer vervolgens de database die de doeltabel bevat.
2. Selecteer Gegevensverbindingen in het menu links. Schakel vervolgens het selectievakje in naast de relevante IoT Hub gegevensverbinding.
3. Selecteer Verwijderen in de bovenste menubalk.

---

Gerelateerde inhoud

• Query's uitvoeren op gegevens in de webinterface van Azure Data Explorer