Amazon IoT TwinMaker 知识图谱其他资源

使用筛选器获取所有实体

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

此查询返回工作空间中名称为的所有实体room_0。

FROM子句：EntityGraph是包含工作空间中所有实体及其关系的图表集合。此集合是 Amazon 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 返回行列表。由于只有一个实体匹配，因此会返回一个包含实体中所有字段的 rowData。

每个节点都包含所有实体级字段（例如entityId、arn和）components、组件级字段（例如和）以及属性级字段（例如componentTypeId和properties）componentName，全部作为嵌套的 JSO propertyName N propertyValue。

使用筛选器获取所有关系：

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

此查询返回工作区中具有关系名称 isLocationOf 的所有关系。

MATCH子句：指定一种模式，该模式匹配两个节点（由指示()），这两个节点通过定向边（由指示-[]->）连接并绑定到名为的变量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。这与实体上定义的关系属性名称相同。sourceEntityId，sourceComponentName并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) 的任意两个节点 (e1,r) 相匹配。

WHERE 子句：指定对关系名称和来源实体名称的筛选器。

子SELECT句：返回e2节点中的entityName字段。

响应

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

在 ColumnDescriptions 中，列的类型是，VALUE因为entityName是字符串。

返回一个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)

这将返回两个匹配项：一个从 'a' 到 'b'，另一个从 'b' 到 'a'，因此建议尽可能使用定向边。

关系名称也是属性图的标签EntityGraph，因此您可以简单地在冒号 (:) 后面指定关系名称，而不必在WHERE子句rel.relationshipName中指定过滤器。

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

链接：可以链接多个模式以在多个关系匹配。

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

可变的跳跃模式也可以跨越多个节点和边缘：

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

此查询匹配任何具有从节点 'a' 传出边缘在 1 到 5 个跳数内的模式。容许的限定符为：

{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 对输出字段名称进行别名化来设置其格式。此处返回的是 roomfunction，则不是响应中作为列名称的 propertyValue。

返回别名：

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%'

强烈建议使用别名，以保持明确性，提高可读性，并避免查询中出现任何歧义。

支持的逻辑运算符有ANDNOT、和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不支持嵌套复杂字段和图表模式字段。

COUNTDISTINCT和嵌套查询不支持聚合。

例如，不支持 COUNT(DISTINCT e.entityId)。

可变跳查询

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

此查询匹配并投影任何模式的节点元数据，这些模式的出站边缘在 1 到 3 跳之间。

固定跳跃查询

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

此查询将实体和传入边的元数据匹配并投影到 b。

非定向查询

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

此查询以 1 跳模式匹配并投影通过 b 连接 a 和 c 的节点的元数据。

{
    "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 操作的可选参数。 max-results仅适用于 API 以及如何在上述查询的范围内读取结果。

max-results在查询中使用允许您在不限制返回结果的实际数量的情况下减少显示结果的数量。

该next-token字符串指定下一页的结果。有关更多信息，请参阅 ExecuteQueryAPI 操作。