本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 如何執行 AWS IoT TwinMaker 知識圖表查詢
<a name="tm-knowledge-graph-use"></a>

在使用 AWS IoT TwinMaker 知識圖表之前，請確定您已完成下列先決條件：
+ 建立 AWS IoT TwinMaker 工作區。您可以在 [AWS IoT TwinMaker 主控台](https://console.aws.amazon.com/iottwinmaker/)中建立工作區。
+ 熟悉 AWS IoT TwinMaker實體元件系統，以及如何建立實體。如需詳細資訊，請參閱[建立您的第一個實體](twinmaker-gs-entity.md)。
+ 熟悉 AWS IoT TwinMaker的資料連接器。如需詳細資訊，請參閱[AWS IoT TwinMaker 資料連接器](data-connector-interface.md)。

**注意**  
若要使用 AWS IoT TwinMaker 知識圖表，您需要處於**標準**或**分層套件**定價模式。如需詳細資訊，請參閱[切換 AWS IoT TwinMaker 定價模式](tm-pricing-mode.md)。

下列程序說明如何撰寫、執行、儲存和編輯查詢。

 **開啟查詢編輯器**   

**導覽至知識圖表查詢編輯器**

1. 開啟 [AWS IoT TwinMaker 主控台](https://console.aws.amazon.com/iottwinmaker/)。

1. 開啟您要在其中使用知識圖表的工作區。

1. 在左側導覽功能表中，選擇**查詢編輯器**。

1. 查詢編輯器隨即開啟。您現在可以在工作區的資源上執行查詢。

 **執行查詢**   

**執行查詢並產生圖形**

1. 在查詢編輯器中，選擇**編輯器**索引標籤以開啟語法編輯器。

1. 在編輯器空間中，撰寫您要針對工作區資源執行的查詢。  
![輸入查詢的編輯器空間。](http://docs.aws.amazon.com/zh_tw/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_%'
   ```
**注意**  
知識圖表語法使用 [PartiQL](https://partiql.org/)。如需此語法的資訊，請參閱 [AWS IoT TwinMaker 知識圖表其他資源](tm-knowledge-graph-resources.md)。

1. 選擇**執行查詢**以執行您建立的請求。

   圖形會根據您的請求產生。  
![顯示上述步驟中詳細說明的查詢結果的圖表。](http://docs.aws.amazon.com/zh_tw/iot-twinmaker/latest/guide/images/tm-kg-graph-output.png)

   上面顯示的範例圖表是以步驟 2 中的查詢範例為基礎。

1. 查詢的結果也會在清單中顯示。選擇**結果**以檢視清單中的查詢結果。

1. 或者，選擇**匯出為**以 JSON 或 CSV 格式匯出查詢結果。

這涵蓋了 主控台中知識圖表的基本使用。如需示範知識圖表語法的詳細資訊和範例，請參閱 [AWS IoT TwinMaker 知識圖表其他資源](tm-knowledge-graph-resources.md)。