ruoyi-ai/docs/script/sql/README.md

SQL 脚本说明

全新安装

执行 ruoyi-ai.sql 即可创建 ruoyi-ai 主库和 snail_job 调度库，并导入初始化数据。

mysql -uroot -p < ruoyi-ai.sql

主 SQL 已合并下表中的全部更新，无需再次执行 update 目录中的脚本。snail_job_mysql.sql 仅用于单独初始化调度库，执行主 SQL 后无需再执行它。

全量初始化包含 DROP TABLE 和调度库的 DROP DATABASE，已有数据库升级应使用对应的增量脚本。

已有数据库升级

连接目标主库后，按文件名升序执行尚未应用的更新脚本；不要根据文件重命名重复执行已应用的更新。

• 2026-06-15-trace.sql 原名为 update-0615-trace.sql，内容未变；其中菜单插入没有判重，不应重复执行。
• 2026-08-30-mcp-market-tool-tenant.sql 是一次性迁移，执行前检查脚本内的预检要求；部分执行失败后应按实际表结构续跑。
• 其余脚本包含重复执行保护，具体适用条件见各脚本注释。

命名约定

更新脚本统一采用 YYYY-MM-DD-功能描述.sql，功能描述使用小写英文和连字符，例如 2026-09-01-sys-url.sql。保留已有更新日期，同日脚本按文件名升序执行，并确保依赖顺序一致。

全量入口保留 ruoyi-ai.sql，独立调度库入口保留 snail_job_mysql.sql。

主 SQL 合并清单

截至 2026-09-01，update 目录的 9 个脚本均已体现在主 SQL 的最终表结构和初始化数据中。结构变更直接并入建表语句，重复配置按最终值保留一份；旧库回填及兼容逻辑保留在增量脚本中。

更新脚本	主 SQL 中对应内容
2026-06-15-trace.sql	trace_run、trace_node 表、租户字段和索引，以及链路追踪菜单
2026-07-20-knowledge-fragment-fid.sql	附件 file_hash、片段 fid、可空的 doc_id 和知识库租户索引
2026-07-21-chat-provider-icon-length.sql	chat_provider.provider_icon 扩展为 varchar(1000)
2026-07-21-sys-config-node-template.sql	7 个工作流节点消息模板配置
2026-07-24-register-default-role-and-missing-menus.sql	默认注册角色、角色菜单关联、默认角色配置，以及会话、附件和片段权限
2026-07-29-sys-config-node-template-all.sql	工作流全部 8 个模板，前 7 个配置与上一批模板合并去重
2026-07-29-zhipu-web-search-node.sql	智谱网络搜索节点及其消息模板；内部组件名保留 Google 以兼容已有流程
2026-08-30-mcp-market-tool-tenant.sql	mcp_market_tool 租户、审计字段和 idx_tenant_market 索引
2026-09-01-sys-url.sql	sys_url 表、5 个菜单权限和 2 条公开链接

后续增加更新脚本时，同步修改主 SQL 中对应的表结构或初始化数据，并更新本清单及主 SQL 文件头。