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

azure_digital_twins_query_request 插件

该azure_digital_twins_query_request插件在Kusto 查询语言 (KQL) 查询中运行 Azure 数字孪生查询。 该插件通过 evaluate 运算符调用。

使用 插件，可以跨 Azure 数字孪生中的数据和可通过 KQL 访问的任何数据源进行查询。 例如，可以 执行时序分析。

有关插件的详细信息，请参阅适用于 Azure 数据资源管理器的 Azure 数字孪生查询插件。

语法

evaluateazure_digital_twins_query_request(AdtInstanceEndpoint,AdtQuery)

详细了解语法约定。

参数

名称	类型	必需	说明
AdtInstanceEndpoint	string	✔️	要查询的 Azure 数字孪生实例终结点。
AdtQuery	string	✔️	要针对 Azure 数字孪生终结点运行的查询。 此查询是使用 Azure 数字孪生的类似 SQL 的自定义查询语言编写的，称为 Azure 数字孪生查询语言。 有关详细信息，请参阅面向 Azure 数字孪生的查询语言。

身份验证和授权

插件azure_digital_twins_query_request使用运行查询的用户的 Microsoft Entra 帐户进行身份验证。 要运行查询，必须至少向用户授予“Azure 数字孪生数字读者”角色。 可以在 Azure 数字孪生解决方案的安全性中找到有关如何分配此角色的信息。

示例

下面的示例演示如何运行各种 Azure 数字孪生查询，包括使用额外 Kusto 表达式的查询。

检索 Azure 数字孪生实例中的所有孪生体

以下示例返回 Azure 数字孪生实例中的所有数字孪生体。

evaluate azure_digital_twins_query_request(
  'https://contoso.api.wcus.digitaltwins.azure.net',
  'SELECT T AS Twins FROM DIGITALTWINS T')

将孪生属性投影为列以及其他 Kusto 表达式

下面的示例将来自插件的结果返回为单独的列，然后使用 Kusto 表达式执行其他操作。

evaluate azure_digital_twins_query_request(
  'https://contoso.api.wcus.digitaltwins.azure.net',
  'SELECT T.Temperature, T.Humidity FROM DIGITALTWINS T WHERE IS_PRIMITIVE(T.Temperature) AND IS_PRIMITIVE(T.Humidity)')
| where Temperature > 20
| project TemperatureInC = Temperature, Humidity

输出

TemperatureInC	湿度
21	48
49	34
80	32

执行时序分析

可以使用 Azure 数字孪生的数据历史记录集成功能来历史记录数字孪生体属性更新。 若要了解如何查看历史化孪生体更新，请参阅在 Azure 数据资源管理器中查看历史化孪生体更新