如何用SurrealQL查询SurrealDB节点关联拓扑及过滤节点属性

1. 实现完整拓扑查询 #

要查询指定A节点实例及其关联的B、C节点完整拓扑（包含节点与关系），可以使用SurrealQL的GRAPH语句结合路径匹配来实现：

示例：查询特定A实例的完整拓扑 #

假设目标A实例的ID为a_instance_001，执行以下语句：

GRAPH
  START AT 'a_instance_001'
  MATCH (AInstance)-[Relationship1]->(BInstance)-[Relationship2]->(CInstance)
  RETURN GRAPH;

• START AT：指定拓扑查询的起始节点ID
• MATCH：定义需要匹配的路径模式，精准对应A→B→C的关联关系
• RETURN GRAPH：返回包含所有匹配节点、关系的完整拓扑结构

如果需要匹配所有层级关联（不限定仅A→B→C），可以简化路径模式：

GRAPH
  START AT 'a_instance_001'
  MATCH (n)-[r]->(m)
  RETURN GRAPH;

2. 节点属性过滤 #

方式1：匹配阶段过滤节点 #

在MATCH或START AT子句中通过WHERE直接过滤符合属性条件的节点，减少不必要的匹配：

-- 过滤状态为active的A实例，以及类型为primary的B实例
GRAPH
  START AT (AInstance WHERE status = 'active')
  MATCH (AInstance)-[Relationship1]->(BInstance WHERE type = 'primary')-[Relationship2]->(CInstance)
  RETURN GRAPH;

方式2：返回阶段过滤属性 #

如果仅需要返回节点的特定属性（而非全部字段），可以在RETURN中自定义输出结构：

-- 从指定A实例出发，仅返回节点的核心属性
MATCH (a:AInstance WHERE id = 'a_instance_001')-[r1:Relationship1]->(b:BInstance)-[r2:Relationship2]->(c:CInstance)
RETURN {
  a_node: {id: a.id, name: a.display_name},
  rel_to_b: r1,
  b_node: {id: b.id, type: b.instance_type},
  rel_to_c: r2,
  c_node: {id: c.id, status: c.run_status}
};

方式3：过滤关联关系的属性 #

如果需要对关系属性进行过滤，同样可以在MATCH中添加WHERE条件：

-- 过滤关联关系中level为high的路径
GRAPH
  START AT 'a_instance_001'
  MATCH (AInstance)-[Relationship1 WHERE level = 'high']->(BInstance)-[Relationship2]->(CInstance)
  RETURN GRAPH;

内容的提问来源于stack exchange，提问作者grooby