az dt data-history connection create

參考

注意

此參考是 Azure CLI 的 azure-iot 延伸模組的一部分 （2.37.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 來取得完整偵錯記錄。

Share via

az dt data-history connection create

命令

az dt data-history connection create adx

範例

必要參數

選擇性參數

意見反應

其他資源