

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 如何运行 Amazon IoT TwinMaker 知识图谱查询
<a name="tm-knowledge-graph-use"></a>

在使用 Amazon IoT TwinMaker 知识图谱之前，请确保您已完成以下先决条件：
+ 创建 Amazon IoT TwinMaker 工作空间。您可以在 [Amazon IoT TwinMaker 控制台](https://console.amazonaws.cn/iottwinmaker/)中创建工作区。
+ 熟悉 Amazon IoT TwinMaker的实体组件系统以及如何创建实体。有关更多信息，请参阅 [创建您的第一个实体](twinmaker-gs-entity.md)。
+ 熟悉 Amazon IoT TwinMaker的数据连接器。有关更多信息，请参阅 [Amazon IoT TwinMaker 数据连接器](data-connector-interface.md)。

**注意**  
要使用 Amazon IoT TwinMaker 知识图表，您需要处于**标准**或**分层捆绑**定价模式。有关更多信息，请参阅 [切换 Amazon IoT TwinMaker 定价模式](tm-pricing-mode.md)。

以下步骤介绍如何编写、运行、保存和编辑查询。

 **打开查询编辑器**   

**导航到知识图谱查询编辑器**

1. 打开 [Amazon IoT TwinMaker 控制台](https://console.amazonaws.cn/iottwinmaker/)。

1. 打开要在其中使用知识图谱的工作区。

1. 在导航窗格中，选择 **查询编辑器**。

1. 查询编辑器打开。您现在可以对工作区资源运行查询。

 **运行查询**   

**运行查询并生成图表**

1. 在查询编辑器中，选择**Editor**（编辑器）选项卡以打开语法编辑器。

1. 在编辑器空间中，编写要对工作区资源运行的查询。  
![已输入查询的编辑器空间。](http://docs.amazonaws.cn/iot-twinmaker/latest/guide/images/kg-query-updated.png)

   在所示的示例中，请求搜索名称`vav_%`中包含的实体，然后使用以下代码按它们之间的`feed`关系组织这些实体。

   ```
   SELECT ahu, vav, r FROM EntityGraph
   MATCH (vav)<-[r:feed]-(ahu)
   WHERE vav.entityName LIKE 'vav_%'
   ```
**注意**  
知识图谱语法使用 P [artiQL。](https://partiql.org/)有关此语法的信息，请参见[Amazon IoT TwinMaker 知识图谱其他资源](tm-knowledge-graph-resources.md)。

1. 选择 “**运行查询**” 以运行您创建的请求。

   图表将根据您的请求生成。  
![显示上述步骤中详述的查询结果的图表。](http://docs.amazonaws.cn/iot-twinmaker/latest/guide/images/tm-kg-graph-output.png)

   上面显示的示例图表基于步骤 2 中的查询示例。

1. 查询的结果也可以列表的形式呈现。选择**结果**以列表形式查看查询结果。

1. 或者，选择**导出为**，以 JSON 或 CSV 格式导出查询结果。

这涵盖了控制台中知识图谱的基本用法。有关展示知识图谱语法的更多信息和示例，请参阅 [Amazon IoT TwinMaker 知识图谱其他资源](tm-knowledge-graph-resources.md)。