IoT Hub adatkapcsolat létrehozása az Azure Data Explorer

Ez a cikk bemutatja, hogyan lehet adatokat beolvasni az Azure-ba Data Explorer IoT Hub, egy big data streamelési platformról és egy IoT-betöltési szolgáltatásból.

Ha meg szeretné tudni, hogyan hozhat létre kapcsolatot a Azure Portal vagy ARM-sablonnal, tekintse meg az IoT-adatkapcsolat létrehozását ismertető cikket.

Az Azure Data Explorer IoT Hub-ból való betöltéséről a Csatlakozás IoT Hub című témakörben talál általános információkat.

Megjegyzés

Csak az adatkapcsolat létrehozása után beküldött események lesznek betöltve.

A korábbi SDK-verziókon alapuló kódmintákért tekintse meg az archivált cikket.

Előfeltételek

• Azure-előfizetés. Hozzon létre egy ingyenes Azure-fiókot.
• Egy Azure-Data Explorer-fürt és -adatbázis. Hozzon létre egy fürtöt és egy adatbázist.
• Céltábla. Hozzon létre egy táblát , vagy használjon egy meglévő táblát.
• A tábla betöltési leképezése .
• Egy IoT Hub a betöltéshez szükséges adatokkal.

IoT Hub adatkapcsolat létrehozása

Ebben a szakaszban kapcsolatot fog létesíteni a IoT Hub és az Azure Data Explorer tábla között. Amíg ez a kapcsolat működik, a rendszer adatokat továbbít a IoT Hub a céltáblába.

Portál

1. Az Azure Data Explorer-fürt bal oldali menüjében válassza az Adatbázisok lehetőséget, majd válassza ki a céltáblát tartalmazó adatbázist.

   

2. Válassza az Adatkapcsolatok és az Adatkapcsolat hozzáadása lehetőséget. A legördülő menüben válassza a IoT Hub lehetőséget.

   

3. Adja meg az alábbi adatokat az űrlapon.

   Beállítás	Mező leírása
   Adatkapcsolat neve	Az Azure-ban létrehozni kívánt kapcsolat neve Data Explorer
   Előfizetés	Az előfizetés azonosítója, ahol az Event Hubs-erőforrás található.
   IoT Hub	IoT Hub neve
   Megosztott hozzáférési szabályzat	A megosztott hozzáférési szabályzat neve. Olvasási engedélyekkel kell rendelkeznie
   Fogyasztói csoport	A IoT Hub beépített végpontban definiált fogyasztói csoport
   Eseményrendszer tulajdonságai	Az IoT Hub eseményrendszer tulajdonságai. Rendszertulajdonságok hozzáadásakor hozzon létre vagy frissítse a táblasémát és a leképezést a kiválasztott tulajdonságok belefoglalásához.

   

   Megjegyzés

   • Az eseményrendszer tulajdonságai egyrekordos események esetén támogatottak.
   • CSV-leképezés esetén a rendszer a rekord elején adja hozzá a tulajdonságokat. JSON-megfeleltetés esetén a tulajdonságok a legördülő listában megjelenő név alapján lesznek hozzáadva.

4. A használati esettől függően érdemes lehet bekapcsolni a többadatbázisos útválasztást. További információ az adatbázis-útválasztásról: Események útválasztása.

   

5. Adja meg a következő útválasztási beállításokat:

   Beállítás	Ajánlott érték	Mező leírása
   Table name (Táblázat neve)	TestTable	A testdb-ben létrehozott tábla.
   Adatformátum	JSON	Támogatott formátumok: AVRO, CSV, JSON, ORC, PARQUET, PSV, SCSV, SOHSV, TSV, TXT, TSVE, APACHE AVRO és W3CLOG.
   Társítás	TestMapping	A testdb-ben létrehozott leképezés, amely leképezi a bejövő adatokat a testdb oszlopneveihez és adattípusaihoz. Ha nincs megadva, a rendszer a tábla sémájából származtatott identitásadatok leképezését használja.

   

   Megjegyzés

   • A JSON-adatok alapértelmezés szerint multijsonként vannak elemezve. Válassza a Formátumhibák figyelmen kívül hagyása lehetőséget az adatok szigorú JSON-formátumban való betöltéséhez.
   • Ha az Eseményrendszer tulajdonságai lehetőséget választotta, a rendszertulajdonságokat bele kell foglalnia a táblasémára és a leképezésbe.

6. Válassza a Létrehozás lehetőséget.

Figyelmeztetés

Manuális feladatátvétel esetén hozza létre újra az adatkapcsolatot.

ARM-sablon

Az alábbi példa egy Azure Resource Manager-sablont mutat be egy IoT Hub adatkapcsolat hozzáadásához. A sablont az űrlap használatával szerkesztheti és helyezheti üzembe a Azure Portal.

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

IoT Hub adatkapcsolat eltávolítása

Ha el szeretné távolítani a IoT Hub kapcsolatot a Azure Portal, tegye a következőket:

1. Nyissa meg a fürtöt. A bal oldali menüben válassza az Adatbázisok lehetőséget. Ezután válassza ki a céltáblát tartalmazó adatbázist.
2. A bal oldali menüben válassza az Adatkapcsolatok lehetőséget. Ezután jelölje be a megfelelő IoT Hub adatkapcsolat melletti jelölőnégyzetet.
3. A felső menüsávon válassza a Törlés lehetőséget.

---

Kapcsolódó tartalom

• Adatok lekérdezése az Azure Data Explorer webes felhasználói felületén