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

Azure 数字孪生查询语言

本文介绍了查询语言及其功能的基础知识。 回忆一下,Azure 数字孪生中心是依据数字孪生体和关系构建的孪生图。 可以查询此图以获取有关数字孪生体及其包含的关系的信息。 这些查询是用类似于 SQL 的自定义查询语言编写的,称为 Azure 数字孪生查询语言。 此语言类似于具有许多可比较功能的 IoT 中心查询语言

有关查询语法以及如何运行查询请求的详细示例,请参阅查询孪生体图

关于查询

可以使用 Azure 数字孪生查询语言根据其属性(包括

  • 标记属性)来检索数字孪生体
  • 模型
  • 关系
    • 关系属性

若要从客户端应用将查询提交到服务,请使用 Azure 数字孪生查询 API。 使用 API 的一种方法是通过 Azure 数字孪生的一个 SDK

参考文档

可以在“Azure 数字孪生”文档左侧目录中的“引用”下找到查询语言引用。 还可以使用如下链接直接跳转到“引用”部分:

查询注意事项

编写 Azure 数字孪生查询时,请注意以下几点:

  • 记得区分大小写:所有 Azure 数字孪生查询操作都区分大小写,因此请务必使用模型中定义的确切名称。 如果属性名称拼写错误或大小写不正确,则结果集为空,并且不返回任何错误。

  • 转义单引号:如果查询文本在数据中包含单引号字符,则需要使用 \ 字符对引号进行转义。 下面是一个处理 D'Souza 属性值的示例

    SELECT * FROM DIGITALTWINS WHERE Name = 'D\'Souza'
    

注意

对图表中的数据进行更改后,可能会有长达 10 秒的延迟才会在查询中反映更改。

DigitalTwins API 会立即反映更改,因此如果需要即时响应,请使用 API 请求 (DigitalTwins GetById) 或 SDK 调用 (GetDigitalTwin) 获取孪生数据,而不是查询。

查询一段时间内的历史孪生数据

Azure 数字孪生语言仅适用于查询数字孪生体和关系的当前状态。

若要对一段时间内收集的孪生图数据运行查询,请使用数据历史记录功能将 Azure 数字孪生实例连接到 Azure 数据资源管理器群集。 这会自动将图的更新历史记录发送到 Azure 数据资源管理器,可在其中使用 Azure 数据资源管理器的 Azure 数字孪生插件查询这些更新。

后续步骤

学习如何编写查询,并查看查询孪生体图中的客户端代码示例。