建立 Azure Data Explorer的IoT 中樞資料連線

本文說明如何從IoT 中樞、巨量資料串流平臺和 IoT 擷取服務將資料內嵌至 Azure Data Explorer。

若要瞭解如何在Azure 入口網站或 ARM 範本中建立連線，請參閱建立 IoT 資料連線。

如需從 IoT 中樞 擷取至 Azure Data Explorer的一般資訊，請參閱連線至IoT 中樞。

注意

只會內嵌在建立資料連線之後排入佇列的事件。

如需以舊版 SDK 為基礎的程式碼範例，請參閱 封存文章。

必要條件

• Azure 訂用帳戶。 建立 Azure 免費帳戶。
• Azure 資料總管叢集和資料庫。 建立叢集和資料庫。
• 目的地資料表。 建立資料表 或使用現有的資料表。
• 資料表的 擷取對應 。
• 具有擷取資料的IoT 中樞。

建立IoT 中樞資料連線

在本節中，您將建立IoT 中樞與 Azure Data Explorer 資料表之間的連線。 只要已備妥此連線，資料就會從IoT 中樞傳輸到目標資料表。

入口網站

1. 在 Azure Data Explorer叢集的左側功能表中，選取 [資料庫]，然後選取包含目標資料表的資料庫。

   

2. 選取 [資料連線] 與 [新增資料連線]。 從下拉式清單中，選取[IoT 中樞]。

   

3. 在表單中填寫以下資訊。

   設定	欄位描述
   資料連線名稱	您想要在 Azure Data Explorer中建立的連線名稱
   訂用帳戶	事件中樞資源所在的訂用帳戶識別碼。
   IoT 中樞	IoT 中樞名稱
   共用存取原則	共用存取原則的名稱。 必須具有讀取權限
   取用者群組	IoT 中樞內建端點中定義的取用者群組
   事件系統屬性	IoT 中樞事件系統屬性。 新增系統屬性時，建立或更新資料表結構描述和對應，以包含選取的屬性。

   

   注意

   • 單一記錄事件支援事件系統屬性。
   • 針對 CSV 對應，屬性會在記錄的開頭新增。 針對 JSON 對應，屬性會根據出現在下拉式清單中的名稱來新增。

4. 根據您的使用案例，您可能想要開啟多資料庫路由。 如需資料庫路由的詳細資訊，請參閱 事件路由。

   

5. 填妥下列路由設定：

   設定	建議的值	欄位描述
   資料表名稱	TestTable	您在 testdb中建立的資料表。
   資料格式	JSON	支援的格式包括 AVRO、CSV、JSON、ORC、PARQUET、PSV、SCSV、SOHSV、TSV、TXT、TSVE、APACHE AVRO 和 W3CLOG。
   對應	TestMapping	您在testdb中建立的對應，會將傳入的資料對應至testdb的資料行名稱和資料類型。 如果未指定，則會使用衍生自資料表架構的 識別資料對應 。

   

   注意

   • JSON 資料預設會剖析為 multijson。 選取 [忽略格式錯誤 ] 以嚴格 JSON 格式擷取資料。
   • 如果您選取 [事件系統屬性]，則必須在資料表架構和對應中包含 系統屬性 。

6. 選取 [建立]。

警告

如果是 手動容錯移轉，請重新建立資料連線。

ARM 範本

下列範例顯示用來新增IoT 中樞資料連線的 Azure Resource Manager 範本。 您可以使用表單，在 Azure 入口網站中編輯和部署範本。

{
    "$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 中樞資料連線

若要從Azure 入口網站移除IoT 中樞連線，請執行下列動作：

1. 移至您的叢集。 從左側功能表中，選取 [ 資料庫]。 然後，選取包含目標資料表的資料庫。
2. 從左側功能表中，選取 [資料連線]。 然後，選取相關IoT 中樞資料連線旁的核取方塊。
3. 從頂端功能表列選取 [ 刪除]。

---

相關內容

• 查詢 Azure Data Explorer Web UI 中的資料