Membuat koneksi data IoT Hub untuk Azure Data Explorer

Artikel ini memperlihatkan kepada Anda cara menyerap data ke Azure Data Explorer dari IoT Hub, platform streaming big data, dan layanan penyerapan IoT.

Untuk mempelajari cara membuat koneksi di portal Azure atau dengan templat ARM, lihat Membuat koneksi data IoT.

Untuk informasi umum tentang menyerap Data Explorer Azure dari IoT Hub, lihat Menyambungkan ke IoT Hub.

Catatan

Hanya peristiwa yang masuk antrean setelah Anda membuat koneksi data yang terserap.

Untuk sampel kode berdasarkan versi SDK sebelumnya, lihat artikel yang diarsipkan.

Prasyarat

• Langganan Azure. Membuat akun Azure gratis.
• Kluster dan database Azure Data Explorer. Membuat kluster dan database.
• Tabel tujuan. Buat tabel atau gunakan tabel yang sudah ada.
• Pemetaan penyerapan untuk tabel.
• IoT Hub dengan data untuk penyerapan.

Membuat koneksi data IoT Hub

Di bagian ini, Anda akan membuat koneksi antara tabel IoT Hub dan Azure Data Explorer Anda. Selama koneksi ini ada, data dikirimkan dari IoT Hub ke tabel target Anda.

Portal

1. Di menu sebelah kiri kluster Azure Data Explorer Anda, pilih Database lalu pilih database yang berisi tabel target Anda.

   

2. Pilih Koneksi data dan Tambahkan koneksi data. Dari menu drop-down, pilih IoT Hub.

   

3. Isi formulir dengan informasi berikut.

   Pengaturan	Deskripsi bidang
   Nama koneksi data	Nama koneksi yang ingin Anda buat di Azure Data Explorer
   Langganan	ID langganan tempat sumber daya Azure Event Hubs berada.
   IoT Hub	Nama IoT Hub
   Kebijakan akses bersama	Nama kebijakan akses bersama. Harus memiliki izin baca
   Grup konsumen	Grup konsumen yang ditentukan dalam titik akhir bawaan IoT Hub
   Properti sistem peristiwa	Properti sistem peristiwa IoT Hub. Saat menambahkan properti sistem, buat atau perbarui skema tabel dan pemetaan untuk menyertakan properti yang dipilih.

   

   Catatan

   • Properti sistem peristiwa didukung untuk peristiwa rekaman tunggal.
   • Untuk pemetaan CSV, properti ditambahkan di awal rekaman. Untuk pemetaan JSON, properti ditambahkan sesuai dengan nama yang muncul di daftar drop-down.

4. Bergantung pada kasus penggunaan Anda, Anda mungkin ingin mengaktifkan perutean multi-database. Untuk informasi selengkapnya tentang perutean database, lihat Perutean peristiwa.

   

5. Isi pengaturan perutean berikut:

   Pengaturan	Nilai yang disarankan	Deskripsi bidang
   Nama tabel	TestTable	Tabel yang Anda buat di testdb.
   Format data	JSON	Format yang didukung adalah AVRO, CSV, JSON, ORC, PARQUET, PSV, SCSV, SOHSV, TSV, TXT, TSVE, APACHE AVRO, dan W3CLOG.
   Pemetaan	TestMapping	Pemetaan yang Anda buat di testdb, yang memetakan data masuk ke nama kolom dan jenis data testdb. Jika tidak ditentukan, pemetaan data identitas yang berasal dari skema tabel digunakan.

   

   Catatan

   • Data JSON diurai sebagai multijson secara default. Pilih Abaikan kesalahan format untuk menyerap data dalam format JSON yang ketat.
   • Jika Anda memilih Properti sistem peristiwa, Anda harus menyertakan properti sistem dalam skema tabel dan pemetaan.

6. Pilih Buat.

Peringatan

Jika terjadi failover manual, buat ulang koneksi data.

Templat ARM

Contoh berikut menunjukkan templat Azure Resource Manager untuk menambahkan koneksi data IoT Hub. Anda dapat mengedit dan menyebarkan templat di portal Microsoft Azure dengan menggunakan formulir.

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

Menghapus koneksi data IoT Hub

Untuk menghapus koneksi IoT Hub dari portal Azure, lakukan hal berikut:

1. Buka kluster Anda. Dari menu sebelah kiri, pilih Database. Kemudian, pilih database yang berisi tabel target.
2. Dari menu sebelah kiri, pilih Koneksi data. Kemudian, pilih kotak centang di samping koneksi data IoT Hub yang relevan.
3. Dari bilah menu atas, pilih Hapus.

---

Konten terkait

• Mengkueri data di antarmuka pengguna web Azure Data Explorer