建立 Azure 數據總管的 IoT 中樞 數據連線

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

若要瞭解如何在 Azure 入口網站 或使用ARM範本建立連線，請參閱建立IoT數據連線。

如需從 IoT 中樞 擷取至 Azure 數據總管的一般資訊，請參閱連線到 IoT 中樞。

注意

只有在您建立數據連線之後才會加入佇列的事件才會內嵌。

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

必要條件

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

建立 IoT 中樞 數據連線

在本節中，您將建立 IoT 中樞 與 Azure 數據總管數據表之間的連線。 只要此連線已就緒，數據就會從 IoT 中樞 傳輸至目標數據表。

入口網站

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

   

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

   

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

   設定	欄位描述
   資料連線名稱	您想要在 Azure 資料總管中建立的連接名稱
   訂用帳戶	事件中樞資源所在的訂用帳戶標識碼。
   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 數據總管 Web UI 中查詢數據