TuGraph Cypher 生成
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_8e432120/sy-tugraph-cypher。
技能介绍
你在写什么查询
很多团队把 OpenCypher 教程或 ChatGPT 生成的语句直接丢进 TuGraph,结果在 CREATE、 RETURN 或 WHERE 里报错。根因往往不是「不会写图查询」,而是 TuGraph 与标准 OpenCypher 在 Schema、Label 和 语法子集 上并不一致:节点/边必须 恰好一个 Label、必须先建 Schema 才能用,且 不能 创建无 Label 节点。
技能如何帮你对齐 TuGraph
本技能把 TuGraph 当作独立方言来约束生成结果,而不是泛泛的「图数据库 Cypher」。它会强调三条架构差异(单 Label、强 Schema、禁止无 Label 节点),并给出 不支持特性速查表,例如:
RETURN *不能一次返回全部变量WHERE里不能写(a)-[]->(b)这类路径过滤- 不支持
node["prop"]动态属性、CREATE p = (a)-[:R]->(b)整路径创建 CALL proc($param)过程参数、SKIP rand()等非常量 SKIP/LIMIT- 反引号变量名、
all()/any()等谓词、以及去重版UNION(仅UNION ALL)
需要细节时,技能会指向 references/quick-reference.md(算子、子句、函数示例)与 references/procedures.md(内置过程签名),避免你在文档外猜语法。
适用边界
内容基于 TuGraph DB 4.5.1;新版本可能增删特性,上线前仍建议对照官方 Release 说明。本技能侧重 可执行的 Cypher 与方言差异,不替代 TuGraph 集群运维、权限或性能调优。
使用场景
- 从 Neo4j 或通用 OpenCypher 示例迁移到 TuGraph 时,改写 `CREATE`/`MATCH` 以符合单 Label 与先建 Schema 的约束
- 在 TuGraph 4.5.1 上调试报错语句,对照不支持列表排查 `RETURN *`、`WHERE` 路径模式或 `UNION` 等非 `UNION ALL` 写法
- 为新业务建模后编写首批图查询,避免生成无 Label 节点或动态属性 `node["prop"]` 等会直接失败的语法
- 需要调用内置过程时,按 `references/procedures.md` 核对过程名与参数签名,避免 `CALL proc($param)` 这类不支持形式
适合人员
- 负责 TuGraph 接入的后端工程师,要把业务 API 里的图查询写成可执行且符合方言的子集
- 维护 TuGraph 实例的 DBA,需要在建表/建 Label 之后帮业务方审查 Cypher 是否触犯强 Schema 与单 Label 规则
- 从 Neo4j 迁到 TuGraph 的数据平台同学,要批量改掉 `RETURN *`、谓词函数和整路径 `CREATE` 等不兼容写法
- 写图分析脚本的数据工程师,要在 Agent 辅助下快速查算子、子句与过程文档而不是背完整手册