你当前正在访问 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 数字孪生查询插件。

语法

evaluate azure_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 中的历史记录化孪生更新数据资源管理器