你当前正在访问 Microsoft Azure Global Edition 技术文档网站。如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

az dt data-history connection create

参考

注意

此参考是 Azure CLI（版本 2.46.0 或更高版本）的 azure-iot 扩展的一部分。该扩展将在首次运行 az dt data-history connection create 命令时自动安装。详细了解扩展。

在数字孪生实例和支持的资源之间创建数据历史记录连接。

命令

名称	说明	类型	状态
az dt data-history connection create adx	创建数字孪生实例与 Azure 数据资源管理器数据库之间的数据历史记录连接。需要预先创建的 Azure 数据资源管理器和事件中心资源。	扩展	GA

az dt data-history connection create adx

创建数字孪生实例与 Azure 数据资源管理器数据库之间的数据历史记录连接。需要预先创建的 Azure 数据资源管理器和事件中心资源。

将提示用户为成功创建连接所需的数字孪生实例或用户分配的标识添加以下角色和权限：

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事件中心使用者组向目标数字孪生实例添加数据历史记录连接。

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事件中心使用者组的数字孪生关联的用户分配标识，将数据历史记录连接添加到目标数字孪生实例。

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 数据资源管理器表名称和事件中心使用者组，将数据历史记录连接添加到目标数字孪生实例。

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}

将数据历史记录连接添加到目标数字孪生实例，该实例与事件中心和 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事件中心使用者组向目标数字孪生实例添加数据历史记录连接，并跳过角色分配提示。

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事件中心使用者组向目标数字孪生实例添加数据历史记录连接，并启用记录属性和项删除。另一列将添加到表中，用于存储对孪生体和关系属性的更新（默认为 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事件中心使用者组向目标数字孪生实例添加数据历史记录连接，并在 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 事件中心使用者组向目标数字孪生实例添加数据历史记录连接，使用自定义孪生属性事件表名称，并在 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

数字孪生实例名称。

--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 数据资源管理器资源组的名称。如果未提供，将使用数字孪生的资源组。

--adx-subscription --adxs

Azure 数据资源管理器所在的订阅的名称或 ID。如果未提供，将使用包含数字孪生实例的订阅。

--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 资源组的名称。如果未提供，将使用数字孪生的资源组。

--ehs --eventhub-subscription

EventHub 所在的订阅的名称或 ID。如果未提供，将使用包含数字孪生实例的订阅。

--mi-user-assigned --user

使用用户分配的托管标识进行数据历史记录连接身份验证。接受标识资源 ID。如果未提供，将改用系统标识。

--no-wait

不等待长时间运行的操作完成。

默认值: False

--resource-group -g

数字孪生实例资源组。可以使用 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

订阅的名称或 ID。可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

提高日志记录详细程度。使用 --debug 获取完整的调试日志。

通过

az dt data-history connection create

命令

az dt data-history connection create adx

示例

必需参数

可选参数

其他资源