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

# AWS IoT TwinMaker ナレッジグラフ
<a name="tm-knowledge-graph"></a>

 AWS IoT TwinMaker ナレッジグラフは、 AWS IoT TwinMaker ワークスペースに含まれるすべての情報を整理し、ビジュアルグラフ形式で表示します。エンティティ、コンポーネント、コンポーネントタイプに対してクエリを実行して、 AWS IoT TwinMaker リソース間のリレーションシップを示す視覚的なグラフを生成できます。

以下のトピックでは、ナレッジグラフを使用し、統合する方法について説明します。

**Topics**
+ [AWS IoT TwinMaker ナレッジグラフの主な概念](#tm-knowledge-graph-concepts)
+ [AWS IoT TwinMaker ナレッジグラフクエリを実行する方法](tm-knowledge-graph-use.md)
+ [ナレッジグラフシーンの統合](tm-knowledge-graph-scene.md)
+ [Grafana で AWS IoT TwinMaker ナレッジグラフを使用する方法](tm-knowledge-Grafana-panel.md)
+ [AWS IoT TwinMaker ナレッジグラフの追加リソース](tm-knowledge-graph-resources.md)

## AWS IoT TwinMaker ナレッジグラフの主な概念
<a name="tm-knowledge-graph-concepts"></a>

このトピックでは、ナレッジグラフ機能の主要な概念と用語について説明します。

**ナレッジグラフの仕組み**:  
ナレッジグラフは、既存の [CreateEntity](https://docs.aws.amazon.com//iot-twinmaker/latest/apireference/API_CreateEntity.html) API または [ UpdateEntity](https://docs.aws.amazon.com//iot-twinmaker/latest/apireference/API_UpdateEntity.html) APIs を使用して、エンティティとそのコンポーネント間の関係を作成します。関係は、エンティティのコンポーネントで定義された特殊なデータ型の [RELATIONSHIP ](https://docs.aws.amazon.com//iot-twinmaker/latest/apireference/API_DataType.html#:~:text=Valid%20Values%3A-,RELATIONSHIP,-%7C%20STRING%20%7C%20LONG%20%7C%20BOOLEAN)のプロパティにすぎません。 AWS IoT TwinMaker ナレッジグラフは、[ExecuteQuery](https://docs.aws.amazon.com/iot-twinmaker/latest/apireference/API_ExecuteQuery.html) API を呼び出して、エンティティ内のデータまたはエンティティ間の関係に基づいてクエリを実行します。ナレッジグラフは、グラフ一致構文のサポートが新しく追加された柔軟な PartiQL クエリ言語 (多くの AWS サービスで使用) を使用して、クエリの記述を支援します。呼び出しが完了したら、結果をテーブルとして表示したり、接続されたノードとエッジのグラフとして視覚化したりできます。

**ナレッジグラフの主要用語**:  
+ **エンティティグラフ**: ワークスペース内のノードとエッジの収集。
+ **ノード**: ワークスペース内のすべてのエンティティがエンティティグラフのノードになります。
+ **エッジ**: エンティティのコンポーネントに定義されているすべてのリレーションシッププロパティがエンティティグラフのエッジになります。さらに、エンティティの parentEntityId フィールドを使用して定義された階層的な親子関係も、エンティティグラフのisChildOf」リレーションシップ名を持つエッジになります。すべてのエッジは方向性のあるエッジです。
+ **関係**: AWS IoT TwinMaker 関係は、エンティティのコンポーネントの特別なタイプのプロパティです。[ CreateEntity](https://docs.aws.amazon.com//iot-twinmaker/latest/apireference/API_CreateEntity.html) または [UpdateEntity](https://docs.aws.amazon.com//iot-twinmaker/latest/apireference/API_UpdateEntity.html) API を使用して AWS IoT TwinMaker 、関係を定義および編集できます。では AWS IoT TwinMaker、エンティティのコンポーネントで関係を定義する必要があります。リレーションシップを独立したリソースとして定義することはできません。リレーションシップは、あるエンティティから別のエンティティへの方向性がある必要があります。