用途:帮助生成 Neo4j Cypher 只读查询,采用现代语法并规避已移除特性,适用于 text2cypher MCP 工具和 LLM 生成 Cypher 的场景。
主要能力:列出需避免的已移除特性,如 id() 改用 elementId()、隐式分组键改用显式 WITH、列表模式表达式改用模式推导或 COLLECT 子查询、重复关系变量改用唯一变量名、自动列表转布尔改用显式检查。提供查询模式选择指南:简单查询用标准模式;变长路径考虑量化路径模式(QPP),如 MATCH (a)-[]-{1,5}(b);聚合用 COUNT{}、EXISTS{}、COLLECT{} 子查询;复杂读取用 CALL 子查询。
必要用法与规则:排序时必须过滤空值,例如 MATCH (n:Node) WHERE n.value IS NOT NULL RETURN n.name, n.value ORDER BY n.value,或使用 NULLS LAST。计数模式用 count{(n)-[]->()} 替代 size();存在性检查用 EXISTS {MATCH ...} 或 exists{(n)-[:REL]->()};元素 ID 用 elementId(n),注意返回字符串而非整数。现代特性包括标签表达式(|、&、!)、类型谓词(IS :: STRING、IS :: INTEGER NOT NULL、IS :: LIST<STRING>)与 CALL 子查询变量作用域。
适用场景:迁移旧版查询、排查遗留语法错误、复杂聚合与排序、变长路径优化、多跳模式匹配。
限制:资料未提供具体版本号、安装命令、收费信息或实测性能数据;QPP 性能提升幅度仅按资料所述,未独立验证。参考文档按需加载 deprecated-syntax.md、subqueries.md、qpp.md。