翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# 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/ja_jp/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/ja_jp/iot-twinmaker/latest/guide/images/tm-kg-graph-output.png)

   上記のグラフ例は、ステップ 2 のクエリ例に基づいています。

1. クエリの結果もリストに表示されます。**結果**を選択して、クエリ結果をリストに表示します。

1. 必要に応じて、 **としてエクスポート**を選択してクエリ結果を JSON または CSV 形式でエクスポートします。

コンソールでのナレッジグラフの基本的な使用方法を説明します。ナレッジグラフ構文の詳細と例については、「[AWS IoT TwinMaker ナレッジグラフの追加リソース](tm-knowledge-graph-resources.md)」を参照してください。