Nebula查询中如何在UNWIND子句内正确使用MATCH

基础环境说明 #

当前图Schema配置：

• 节点标签
  • Person：携带name字符串属性，存储人员姓名
  • Location：携带name字符串属性，存储地点名称
• 边类型
  • HAS_LIVED：方向为Person指向Location，代表对应人员曾在某地居住

问题复现 #

使用UNWIND传入姓名列表执行关联查询，语句如下：

UNWIND ["Anna", "Emma", "Zach"] AS n
MATCH (p:Person {name: n})-[:HAS_LIVED]->(loc)
RETURN loc.Location.name

预期返回三个人员对应的居住地点["London", "Paris", "Berlin"]，实际执行无任何结果。移除UNWIND子句，对列表内每个姓名单独编写MATCH查询，均可正常返回正确结果。

问题成因 #

该问题是Nebula Graph 3.5以前版本的优化器限制导致：
当MATCH子句中标签内联的属性等值匹配条件使用UNWIND生成的动态变量（而非固定字符串字面量）时，优化器无法自动将该属性过滤条件下推到存储层走属性索引点查，会触发全量Person节点+HAS_LIVED边的扫描。如果实例配置了内存扫描阈值限制，扫描过程会被提前终止，且不会抛出显式错误，最终返回空结果。
单独执行字面量匹配查询时，优化器可直接识别固定值走索引点查路径，扫描数据量极小，因此可以正常返回。

修复方案 #

方案1：调整查询写法（推荐） #

将属性过滤逻辑从标签内联写法移到WHERE子句，引导优化器识别过滤条件下推索引，同时如果需要返回数组格式结果，补充collect聚合函数：

UNWIND ["Anna", "Emma", "Zach"] AS n
MATCH (p:Person)-[:HAS_LIVED]->(loc:Location)
WHERE p.name == n
RETURN collect(loc.name) AS lived_locations

方案2：原生语法兼容写法（适配所有Nebula版本） #

如果调整写法后仍存在兼容问题，可使用Nebula原生的LOOKUP+GO语法实现相同逻辑，执行效率更稳定：

// 1. 基于属性索引匹配所有目标Person点
LOOKUP ON Person WHERE Person.name IN ["Anna", "Emma", "Zach"] YIELD id(vertex) AS p_id
// 2. 沿HAS_LIVED边查询关联的Location点ID
| GO FROM $-.p_id OVER HAS_LIVED YIELD HAS_LIVED._dst AS loc_id
// 3. 拉取Location点的name属性
| FETCH PROP ON Location $-.loc_id YIELD properties(vertex).name AS location_name

前置依赖检查 #

上述两种写法都需要提前为Person标签的name属性创建字符串索引，否则属性过滤查询无法正常执行，索引创建语句参考：

CREATE TAG INDEX IF NOT EXISTS idx_person_name ON Person(name(32));

括号内数值为字符串索引前缀长度，根据实际业务中姓名字段的最大长度调整即可。

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