共用方式為


az dt data-history connection create

注意

此參考是 Azure CLI 的 azure-iot 延伸模組的一部分(2.46.0 版或更高版本)。 擴充功能會在您第一次執行 az dt data-history connection create 命令時自動安裝。 深入了解擴充功能。

建立 Digital Twins 實例與支援資源之間的數據歷程記錄連線。

命令

名稱 Description 類型 狀態
az dt data-history connection create adx

建立 Digital Twins 實例與 Azure 數據總管資料庫之間的數據歷程記錄連線。 需要預先建立的 Azure 數據總管和事件中樞資源。

副檔名 GA

az dt data-history connection create adx

建立 Digital Twins 實例與 Azure 數據總管資料庫之間的數據歷程記錄連線。 需要預先建立的 Azure 數據總管和事件中樞資源。

會提示使用者在 Digital Twins 實例或成功建立連線所需的使用者指派身分識別上新增下列角色和許可權:

  • Azure 數據總管資料庫範圍的「參與者」角色
  • Azure 數據總管資料庫範圍的「資料庫管理員」許可權
  • 事件中樞範圍的「Azure 事件中樞 數據擁有者」角色。
az dt data-history connection create adx --adx-cluster-name
                                         --adx-database-name
                                         --cn
                                         --dt-name
                                         --eh
                                         --ehn
                                         [--adx-property-events-table]
                                         [--adx-record-removals {false, true}]
                                         [--adx-relationship-events-table]
                                         [--adx-resource-group]
                                         [--adx-subscription]
                                         [--adx-table-name]
                                         [--adx-twin-events-table]
                                         [--ehc]
                                         [--ehg]
                                         [--ehs]
                                         [--mi-user-assigned]
                                         [--no-wait]
                                         [--resource-group]
                                         [--yes]

範例

使用$Default事件中樞取用者群組,將數據歷程記錄連線新增至目標 Digital Twins 實例。

az dt data-history connection create adx -n {instance_name} --cn {time_series_database_connection_name} --adx-cluster-name {adx_cluster_name} --adx-database-name {adx_database_name} --eventhub {event_hub} --eventhub-namespace {event_hub_namespace}

使用與數字對應項相關聯的使用者指派身分識別與$Default事件中樞取用者群組相關聯的使用者指派身分識別,將數據歷程記錄連線新增至目標 Digital Twins 實例。

az dt data-history connection create adx -n {instance_name} --cn {time_series_database_connection_name} --adx-cluster-name {adx_cluster_name} --adx-database-name {adx_database_name} --eventhub {event_hub} --eventhub-namespace {event_hub_namespace} --mi-user-assigned {resource_id}

使用自定義 Azure 數據總管數據表名稱和事件中樞取用者群組,將數據歷程記錄連線新增至目標 Digital Twins 實例。

az dt data-history connection create adx -n {instance_name} --cn {time_series_database_connection_name} --adx-cluster-name {adx_cluster_name} --adx-database-name {adx_database_name} --adx-property-events-table {adx_property_events_table_name} --eventhub {event_hub} --eventhub-namespace {event_hub_namespace} --eventhub-consumer-group {event_hub_consumer_group}

將數據歷程記錄連線新增至目標 Digital Twins 實例,並與目標實例的不同資源群組和訂用帳戶中的事件中樞和 Azure 數據總管實例整合。

az dt data-history connection create adx -n {instance_name} --cn {time_series_database_connection_name} --adx-cluster-name {adx_cluster_name} --adx-database-name {adx_database_name} --adx-resource-group {adx_resource_group} --adx-subscription {adx_subscription} --eventhub {event_hub} --eventhub-namespace {event_hub_namespace} --eventhub-resource-group {event_hub_resource_group} --eventhub-subscription {event_subscription}

使用$Default事件中樞取用者群組,將數據歷程記錄連線新增至目標 Digital Twins 實例,並略過角色指派提示。

az dt data-history connection create adx -n {instance_name} -y --cn {time_series_database_connection_name} --adx-cluster-name {adx_cluster_name} --adx-database-name {adx_database_name} --eventhub {event_hub} --eventhub-namespace {event_hub_namespace}

使用$Default事件中樞取用者群組,將數據歷程記錄連線新增至目標 Digital Twins 實例,並啟用記錄屬性和項目移除。 系統會將額外的數據行新增至數據表,以儲存對應項和關聯性屬性的更新(預設為 AdtPropertyEvents)。

az dt data-history connection create adx -n {instance_name} --cn {time_series_database_connection_name} --adx-cluster-name {adx_cluster_name} --adx-database-name {adx_database_name} --eventhub {event_hub} --eventhub-namespace {event_hub_namespace} --adx-record-removals true

使用 $Default 事件中樞取用者群組,將數據歷程記錄連線新增至目標 Digital Twins 實例,並在 Azure 數據總管資料庫中建立兩個額外的數據表。 其中一個數據表將用於記錄對應項生命週期事件,另一個用於關聯性生命週期事件。

az dt data-history connection create adx -n {instance_name} --cn {time_series_database_connection_name} --adx-cluster-name {adx_cluster_name} --adx-database-name {adx_database_name} --eventhub {event_hub} --eventhub-namespace {event_hub_namespace} --adx-twin-events-table {adx_twin_events_table_name} --adx-relationship-events-table {adx_relationship_events_table_name}

使用$Default事件中樞取用者群組,將數據歷程記錄連線新增至目標 Digital Twins 實例、使用自定義對應項屬性事件數據表名稱,並在 Azure 數據總管資料庫中建立兩個額外的數據表。

az dt data-history connection create adx -n {instance_name} --cn {time_series_database_connection_name} --adx-cluster-name {adx_cluster_name} --adx-database-name {adx_database_name} --eventhub {event_hub} --eventhub-namespace {event_hub_namespace} --adx-property-events-table {adx_property_events_table_name} --adx-twin-events-table {adx_twin_events_table_name} --adx-relationship-events-table {adx_relationship_events_table_name}

必要參數

--adx-cluster-name --adxc

要與整合的 Azure 數據總管叢集名稱。

--adx-database-name --adxd

要與整合的 Azure 數據總管資料庫名稱。

--cn --conn-name

數據歷程記錄連線的名稱。

--dt-name --dtn -n

Digital Twins 實例名稱。

--eh --eventhub

要與整合的 EventHub 名稱。

--ehn --eventhub-namespace

EventHub 命名空間標識碼。

選擇性參數

--adx-property-events-table --adxpet

用來儲存對應項和關聯性屬性更新的 Azure 數據總管數據表名稱。

預設值: AdtPropertyEvents
--adx-record-removals --adxrr

指定是否要記錄對應項/關聯性屬性和項目移除,包括移除索引或索引值(例如對應專案、陣列元素等)。 將此屬性設定為 『true』 將會產生 ADX 中屬性事件資料表中的其他資料行。

接受的值: false, true
預設值: False
--adx-relationship-events-table --adxret

用來記錄關聯性生命週期事件的 Azure 數據總管數據表名稱。 如果未指定此屬性,則不會建立數據表。

--adx-resource-group --adxg

Azure 數據總管資源群組的名稱。 如果未提供,則會使用 Digital Twin 的資源群組。

--adx-subscription --adxs

Azure 數據總管所在的訂用帳戶名稱或標識符。 如果未提供,將會使用包含 Digital Twin 實例的訂用帳戶。

--adx-table-name --adxt
已被取代

選項 '--adx-table-name' 已被取代,將在未來的版本中移除。 請改用 『--adx-property-events-table』。

用來儲存對應項和關聯性屬性更新的 Azure 數據總管數據表名稱。

預設值: AdtPropertyEvents
--adx-twin-events-table --adxtet

用來記錄對應項生命週期事件的 Azure 數據總管數據表名稱。 如果未指定此屬性,則不會建立數據表。

--ehc --eventhub-consumer-group

ADX 從 EventHub 讀取時要使用的 EventHub 取用者群組。

預設值: $Default
--ehg --eventhub-resource-group

EventHub 資源群組的名稱。 如果未提供,則會使用 Digital Twin 的資源群組。

--ehs --eventhub-subscription

EventHub 所在的訂用帳戶名稱或標識符。 如果未提供,將會使用包含 Digital Twin 實例的訂用帳戶。

--mi-user-assigned --user

使用使用者指派的受控識別進行數據歷程記錄連線驗證。 接受識別資源標識碼。如果未提供,將會改用系統身分識別。

--no-wait

請勿等候長時間執行的作業完成。

預設值: False
--resource-group -g

Digital Twins 實例資源群組。 您可以使用 az configure --defaults group=<name> 來設定預設群組。

--yes -y

指派必要角色時,請勿提示確認。

預設值: False
全域參數
--debug

增加記錄詳細資訊,以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤,隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
預設值: json
--query

JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 az account set -s NAME_OR_ID 設定預設訂用帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。