用途:在编写、优化或调试 Cypher 查询时使用,覆盖图模式匹配、QPE(量化路径模式)、变长路径、向量与全文检索、子查询、批量写入和 LOAD CSV。不适用于驱动迁移/API 变更、数据库管理(用户、配置、备份),以及融合向量与全文等多路排序来源的混合检索。
主要能力:默认以 CYPHER 25 作为首 token;遵循 schema 优先(先检查库结构再写查询);MERGE 仅基于受约束键、关系 MERGE 仅用于已绑定端点;探索性读取默认 LIMIT 25;支持 EXISTS/COUNT/COLLECT 子查询、CALL (x) {} 相关子查询、CALL IN TRANSACTIONS 批量写入、CONCURRENT TRANSACTIONS 与 DISJOINT BY 防死锁、SHORTEST/ACYCLIC 路径模式、动态标签与关系类型、字符串插值、UUID 类型、空间 Point 与距离计算、分组聚合与 GROUP BY 子句。
必要用法:默认输出参数化查询并返回具名属性而非整节点。写操作前先 EXPLAIN,确认后再执行;新读查询先用 LIMIT 1 验证;用 PROFILE 检查 AllNodesScan、CartesianProduct、Eager。可通过 Query API v2 执行(curl -X POST https://<instance>.databases.neo4j.io/db/<database>/query/v2,本地为 http://localhost:7474/db/<database>/query/v2)。校验时检查标签存在、关系类型与方向正确、属性属于该标签、索引 ONLINE。
限制:GQL 一致性引入的 LET、FINISH、FILTER、INSERT 属 Cypher 25 子句,多出现在 Neo4j 2025.06 及以后,旧版需回退;INSERT 要求 & 分隔的多标签且不支持动态标签/类型。版本未知时默认使用 2025.01 安全特性集。UUID 属性需 Neo4j 2026.08 及以上,旧驱动可能返回占位 MAP 并提示 03N95。具体版本门槛与回退方案见参考资料。资料未提供收费、价格或平台信息。