你当前正在访问 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 数字孪生插件查询这些更新。
后续步骤
学习如何编写查询，并查看查询孪生体图中的客户端代码示例。