AWS IoT TwinMaker ナレッジグラフの追加リソース

フィルターを使用してすべてのエンティティを取得

SELECT entity
FROM EntityGraph MATCH (entity)
WHERE entity.entityName = 'room_0'

このクエリは、ワークスペース内のすべてのエンティティを という名前で返しますroom_0。

FROM 句: EntityGraph は、ワークスペース内のすべてのエンティティとその関係を含むグラフコレクションです。このコレクションは、ワークスペース内のエンティティ AWS IoT TwinMaker に基づいて によって自動的に作成および管理されます。

MATCH 句: グラフの一部と一致するパターンを指定します。この場合、パターン (entity) はグラフ内のすべてのノードと一致し、エンティティ変数にバインドされます。FROM 句の後には MATCH 句が続く必要があります。

WHERE 句: ノードの entityNameフィールドでフィルターを指定します。値は と一致する必要がありますroom_0。

SELECT 句: エンティティノード全体が返されるように entity変数を指定します。

レスポンス:

{
  "columnDescriptions": [
    {
      "name": "entity",
      "type": "NODE"
    }
  ],
  "rows": [
    {
      "rowData": [
        {
          "arn": "arn:aws:iottwinmaker:us-east-1: 577476956029: workspace / SmartBuilding8292022 / entity / room_18f3ef90 - 7197 - 53 d1 - abab - db9c9ad02781 ",
          "creationDate": 1661811123914,
          "entityId": "room_18f3ef90-7197-53d1-abab-db9c9ad02781",
          "entityName": "room_0",
          "lastUpdateDate": 1661811125072,
          "workspaceId": "SmartBuilding8292022",
          "description": "",
          "components": [
            {
              "componentName": "RoomComponent",
              "componentTypeId": "com.example.query.construction.room",
              "properties": [
                {
                  "propertyName": "roomFunction",
                  "propertyValue": "meeting"
                },
                {
                  "propertyName": "roomNumber",
                  "propertyValue": 0
                }
              ]
            }
          ]
        }
      ]
    }
  ]
}

は、名前やタイプなど、列に関するメタデータcolumnDescriptionsを返します。返されるタイプは、NODE です。これはノード全体が返されたことを示しています。型の他の値は、関係を示すEDGEか、整数や文字列などのスカラー値VALUEを示すことができます。

rows は行のリストを返します。一致したエンティティは 1 つだけなので、エンティティのすべてのフィールドを含む 1 つの rowData が返されます。

各ノードには、entityId、、 arn などのエンティティレベルのフィールドcomponents、、 componentNameなどのコンポーネントレベルのフィールド、componentTypeIdpropertiesおよび propertyNameや などのプロパティレベルのフィールドpropertyValueがすべてネストされた JSON として含まれます。

すべてのリレーションシップをフィルターで取得:

SELECT relationship
FROM EntityGraph MATCH (e1)-[relationship]->(e2)
WHERE relationship.relationshipName = 'isLocationOf'

このクエリは、ワークスペース内のすべてのリレーションシップをリレーション名 isLocationOf で返します。

MATCH 句: は、有向エッジ ( で示される()) によって接続され、 という変数にバインドされている 2 つのノード ( で示される-[]->) に一致するパターンを指定しますrelationship。

WHERE 句: エッジの relationshipNameフィールドでフィルターを指定します。値は ですisLocationOf。

SELECT 句: エッジノード全体が返されるようリレーションシップ変数を指定します。

レスポンス

{
    "columnDescriptions": [{
        "name": "relationship",
        "type": "EDGE"
    }],
    "rows": [{
        "rowData": [{
            "relationshipName": "isLocationOf",
            "sourceEntityId": "floor_83faea7a-ea3b-56b7-8e22-562f0cf90c5a",
            "targetEntityId": "building_4ec7f9e9-e67e-543f-9d1b- 235df7e3f6a8",
            "sourceComponentName": "FloorComponent",
            "sourceComponentTypeId": "com.example.query.construction.floor"
        }]
    },
        ... //rest of the rows are omitted
    ]
}

の列のタイプは columnDescriptionsですEDGE。

各 は、 のようなフィールドを持つエッジrowDataを表しますrelationshipName。これは、エンティティで定義されているリレーションシッププロパティ名と同じです。、sourceComponentName、および はsourceEntityId、リレーションシッププロパティが定義されたエンティティとコンポーネントに関する情報sourceComponentTypeIdを提供します。は、この関係が指すエンティティtargetEntityIdを指定します。

特定のエンティティと特定の関係を持つすべてのエンティティを取得する

SELECT e2.entityName
      FROM EntityGraph MATCH (e1)-[r]->(e2)
      WHERE relationship.relationshipName = 'isLocationOf'
      AND e1.entityName = 'room_0'

このクエリは、エンティティとisLocationOf関係があるすべてのエンティティのすべてのroom_0エンティティ名を返します。

MATCH 句: 有向エッジ (e2) を持つ任意の 2 つのノード (e1、) に一致するパターンを指定しますr。

WHERE 句: リレーションシップ名とソースエンティティ名のフィルターを指定します。

SELECT 句: e2ノードの entityNameフィールドを返します。

レスポンス

{
  "columnDescriptions": [
    {
       "name": "entityName",
       "type": "VALUE"
    }
  ],
   "rows": [
    {
       "rowData": [
         "floor_0"
      ]
    }
  ]
}

columnDescriptions では、列のタイプは VALUE であるため、 は文字列entityNameです。

1 つのエンティティ floor_0が返されます。

ノード 'a' を指す一致ノード 'b':

FROM EntityGraph MATCH (a)-[rel]-(b)

ノード 'b' を指す一致ノード 'a':

FROM EntityGraph MATCH (a)-[]->(b)

リレーションシップにフィルターを指定する必要がないと仮定して、リレーションシップに変数がバインドされることはありません。

ノード「b」を指すノード「a」とノード「a」を指すノード「b」を一致させます。

FROM EntityGraph MATCH (a)-[rel]-(b)

これにより 2 つの一致が返されます。1 つは「a」から「b」、もう 1 つは「b」から「a」であるため、可能な限り有向エッジを使用することをお勧めします。

関係名はプロパティグラフ のラベルでもあるためEntityGraph、 WHERErel.relationshipName句で にフィルターを指定する代わりに、コロン (:) の後に関係名を簡単に指定できます。

FROM EntityGraph MATCH (a)-[:isLocationOf]-(b)

チェーン: 複数のリレーションシップに一致するようにパターンを連鎖させることができます。

FROM EntityGraph MATCH (a)-[rel1]->(b)-[rel2]-(c)

変数ホップパターンは、複数のノードやエッジにまたがっていることもあります。

FROM EntityGraph MATCH (a)-[]->{1,5}(b)

このクエリは、1～5 ホップ内のノード「a」からの送信エッジを持つ任意のパターンに一致します。指定できる格量指定子は次のとおりです。

{m,n} - m 回から n 回の間の繰り返し

{m,} - m 回以上の繰り返し。

ノードを返す:

SELECT e
FROM EntityGraph MATCH (e)

エッジを返す:

SELECT r
FROM EntityGraph MATCH (e1)-[r]->(e2)

スカラー値を返す:

SELECT floor.entityName, room.description, p.propertyValue AS roomfunction
FROM EntityGraph MATCH (floor)-[:isLocationOf]-(room),
room.components AS c, c.properties AS p

AS を使用してエイリアシングで出力フィールドの名前をフォーマットします。ここでは、レスポンス内の列名の propertyValue の代わりに、roomfunction が返されます。

エイリアスを返す:

SELECT floor.entityName AS floorName, luminaire.entityName as luminaireName
FROM EntityGraph MATCH (floor)-[:isLocationOf]-(room)-[:hasPart]-
(lightingZone)-[:feed]-(luminaire)
WHERE floor.entityName = 'floor_0'
AND luminaire.entityName like 'lumin%'

エイリアスの使用は、明示的であり、読みやすくし、クエリのあいまいさを避けることを強くお勧めします。

サポートされている論理演算子は、AND、NOT、および ですOR。

サポートされている比較演算子は、<、<=、>、=>、= および != です。

同じフィールドに複数のOR条件を指定する場合は、 INキーワードを使用します。

エンティティ、コンポーネント、またはプロパティフィールドで絞り込みます。

FROM EntityGraph MATCH (e), e.components AS c, c.properties AS p
WHERE e.entityName = 'room_0'
AND c.componentTypeId = 'com.example.query.construction.room',
AND p.propertyName = 'roomFunction'
AND NOT p.propertyValue = 'meeting'
OR p.propertyValue = 'office'

configuration プロパティでフィルタリングします。設定マップのunitキーと値Celsiusは次のとおりです。

WHERE p.definition.configuration.unit = 'Celsius'

マッププロパティに指定されたキーと値が含まれているかどうかを確認します。

WHERE p.propertyValue.length = 20.0

マッププロパティに指定されたキーが含まれているかどうかを確認します。

WHERE NOT p.propertyValue.length IS MISSING

リストプロパティに指定された値が含まれているかどうかを確認します。

WHERE 10.0 IN p.propertyValue

大文字と小文字を区別しない比較にはこの lower() 関数を使用します。デフォルトでは、大文字と小文字を区別した比較が使用されます。

WHERE lower(p.propertyValue) = 'meeting'

インフィックス検索: %room%

プレフィックス検索: room%

サフィックス検索: %room

値に '%' がある場合は、 にエスケープ文字を入力しLIKE、 でエスケープ文字を指定しますESCAPE。

DISTINCT キーワードは、最終結果から重複を排除します。

DISTINCT は複雑なデータ型ではサポートされていません。

COUNT キーワードは、クエリ結果の項目数を計算します。

COUNT は、ネストされた複合フィールドとグラフパターンフィールドではサポートされていません。

COUNT 集約は、 DISTINCTおよびネストされたクエリではサポートされていません。

たとえば、COUNT(DISTINCT e.entityId) はサポートされません。

変数ホップクエリ

SELECT p FROM EntityGraph MATCH p = (a)-[]->{1, 3}(b)

このクエリは、ノード a からの出力エッジが 1 ～ 3 ホップ以内のパターンのノードメタデータを照合して射影します。

ホップクエリを修正しました

SELECT p FROM EntityGraph MATCH p = (a)-[]->(b)<-[]-(c)

このクエリは、エンティティと受信エッジのメタデータを一致させ、b に射影します。

リダイレクトされないクエリ

SELECT p FROM EntityGraph MATCH p = (a)-[]-(b)-[]-(c)

このクエリは、b を介して a と c を接続する 1 つのホップパターンでノードのメタデータを照合して射影します。

{
    "columnDescriptions": [
        {
            "name": "path",
            "type": "PATH"
        }
    ],
    "rows": [
        {
            "rowData": [
                {
                    "path": [
                        {
                            "entityId": "a",
                            "entityName": "a"
                        },
                        {
                            "relationshipName": "a-to-b-relation",
                            "sourceEntityId": "a",
                            "targetEntityId": "b"
                        },
                        {
                            "entityId": "b",
                            "entityName": "b"
                        }
                    ]
                }
            ]
        },
        {
            "rowData": [
                {
                    "path": [
                        {
                            "entityId": "b",
                            "entityName": "b"
                        },
                        {
                            "relationshipName": "b-to-c-relation",
                            "sourceEntityId": "b",
                            "targetEntityId": "c"
                        },
                        {
                            "entityId": "c",
                            "entityName": "c"
                        }
                    ]
                }
            ]
        }
    ]
}

このPATHクエリレスポンスは、b を介して a と c の間の各パス/パターンのすべてのノードとエッジを識別するメタデータのみで構成されます。

LIMIT キーワードはクエリに影響し、結果の行を制限します。返される結果の合計数を制限せずに、API コールごとに返される結果の数を制御する必要がある場合は、 を使用しますLIMIT。

max-results は、ExecuteQuery API アクションのオプションパラメータです。 は API と、上記のクエリの範囲内で結果がどのように読み取られるかmax-resultsにのみ適用されます。

クエリmax-resultsで を使用すると、返される結果の実際の数を制限することなく、表示される結果の数を減らすことができます。

next-token 文字列は結果の次のページを指定します。詳細については、ExecuteQuery API アクション」を参照してください。