AGE中age_relationships函数处理PATH时的多次调用机制疑问

我分析了age_relationships()函数，通过GDB调试发现该函数会针对每条可用路径被多次调用。例如，执行查询两个节点间所有路径的SQL语句：

SELECT * FROM cypher('graph_name', $$
MATCH (v:Person {lastName: 'Beran'}), (v2:Person {lastName: 'Jones'}), p=((v)-[Knows*..15]-(v2))
RETURN relationships(p)
$$) AS (shortestpath agtype);

其中relationships(p)等价于age_relationships()，会针对两个节点间的每条路径单独调用。我原本以为该函数会一次性处理所有路径，伪代码逻辑如下：

age_relationships(paths):
    for every path in paths:
        retrieve path

但实际执行逻辑却是：

for every path in paths:
    age_relationships(path):
        retrieve path

请问为何会采用这种执行机制？

这种设计主要是贴合PostgreSQL的执行模型，同时兼顾路径查询的灵活性和内存效率：

• PostgreSQL行级执行模型约束：作为PostgreSQL扩展，AGE遵循PostgreSQL核心执行逻辑——查询结果以行为单位逐行处理。当Cypher查询返回多条路径时，每条路径会被视为单独的行数据，age_relationships()作为行级函数，自然会被逐行调用，而非一次性接收所有路径集合。

• 内存资源优化：如果一次性处理所有路径，当路径数量极大（比如允许15跳的查询可能生成数万条结果），会瞬间占用大量内存存储全部路径数据。逐行处理可以生成一条路径就立即处理并释放部分资源，避免内存过载。

• 函数职责单一性：age_relationships()的核心职责是提取单条路径中的关系集合，保持单一职责能让代码更易维护、测试和扩展。若改成处理路径集合，函数逻辑会复杂化，还需额外处理集合的序列化/反序列化逻辑。

• 对齐Cypher语义：在Cypher语法中，relationships(p)的语义是针对单个路径变量p提取其关系，而非针对所有路径的集合。逐行调用的方式正好匹配这一语义设计，让用户查询意图和底层执行逻辑保持一致。

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