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

az dt data-history connection

注意

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

管理和配置数据历史记录连接。

命令

名称	说明	类型	状态
az dt data-history connection create	在数字孪生实例和支持的资源之间创建数据历史记录连接。	分机	GA
az dt data-history connection create adx	创建数字孪生实例与 Azure 数据资源管理器 数据库之间的数据历史记录连接。 需要预先创建的 Azure 数据资源管理器 和事件中心资源。	分机	GA
az dt data-history connection delete	删除在数字孪生实例上配置的数据历史记录连接。	扩展	GA
az dt data-history connection list	列出在数字孪生实例上配置的所有数据历史记录连接。	扩展	GA
az dt data-history connection show	显示在数字孪生实例上配置的数据历史记录连接的详细信息。	扩展	GA
az dt data-history connection wait	等待数据历史记录连接的操作完成。	分机	GA

az dt data-history connection delete

删除在数字孪生实例上配置的数据历史记录连接。

az dt data-history connection delete --cn
                                     --dt-name
                                     [--clean {false, true}]
                                     [--no-wait]
                                     [--resource-group]
                                     [--yes]

示例

删除在实例上配置的数据历史记录连接，并阻止操作完成。

az dt data-history connection delete -n {instance_name} --cn {time_series_database_connection_name}

在不确认或阻止的情况下删除实例上配置的数据历史记录连接。

az dt data-history connection delete -n {instance_name} --cn {time_series_database_connection_name} -y --no-wait

删除在实例上配置的数据历史记录连接，并尝试清理创建连接时创建的项目。 如果未设置适当的权限，则尝试可能会失败。 不会删除记录的数据。

az dt data-history connection delete -n {instance_name} --cn {time_series_database_connection_name} --clean

必需参数

--cn --conn-name

数据历史记录连接的名称。

--dt-name --dtn -n

数字孪生实例名称。

可选参数

--clean -c

指定是否尝试清理创建的项目，以便与时序数据库建立连接。 这是一项最佳尝试，如果适当的权限未到位，将失败。 将此设置为“true”不会删除任何记录的数据。

接受的值: false, true

默认值: False

--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 list

列出在数字孪生实例上配置的所有数据历史记录连接。

az dt data-history connection list --dt-name
                                   [--resource-group]

示例

列出在实例上配置的所有数据历史记录连接。

az dt data-history connection list -n {instance_name}

必需参数

--dt-name --dtn -n

数字孪生实例名称。

可选参数

--resource-group -g

数字孪生实例资源组。 可以使用 az configure --defaults group=<name> 配置默认组。

全局参数

--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 show

显示在数字孪生实例上配置的数据历史记录连接的详细信息。

az dt data-history connection show --cn
                                   --dt-name
                                   [--resource-group]

示例

显示在实例上配置的数据历史记录连接。

az dt data-history connection show -n {instance_name} --cn {time_series_database_connection_name}

必需参数

--cn --conn-name

数据历史记录连接的名称。

--dt-name --dtn -n

数字孪生实例名称。

可选参数

--resource-group -g

数字孪生实例资源组。 可以使用 az configure --defaults group=<name> 配置默认组。

全局参数

--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 wait

等待数据历史记录连接的操作完成。

az dt data-history connection wait --cn
                                   --dt-name
                                   [--created]
                                   [--custom]
                                   [--deleted]
                                   [--exists]
                                   [--interval]
                                   [--resource-group]
                                   [--timeout]
                                   [--updated]

示例

等待数据历史记录连接创建。

az dt data-history connection wait -n {instance_name} --cn {time_series_database_connection_name} --created

等到删除现有数据历史记录连接。

az dt data-history connection wait -n {instance_name} --cn {time_series_database_connection_name} --deleted

必需参数

--cn --conn-name

数据历史记录连接的名称。

--dt-name --dtn -n

数字孪生实例名称。

可选参数

--created

等待在“Succeeded”中使用“provisioningState”创建。

默认值: False

--custom

等待条件满足自定义 JMESPath 查询。 例如 provisioningState！='InProgress'， instanceView.statuses[？code=='PowerState/running']。

--deleted

等到删除为止。

默认值: False

--exists

等待资源存在。

默认值: False

--interval

轮询间隔（以秒为单位）。

默认值: 30

--resource-group -g

数字孪生实例资源组。 可以使用 az configure --defaults group=<name> 配置默认组。

--timeout

最大等待（以秒为单位）。

默认值: 3600

--updated

等到 provisioningState 更新为“Succeeded”。

默认值: 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 获取完整的调试日志。