Flydb CLI 独立发行包
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装该技能 @user_c9b8aa6a/flydb-cli-release。
技能介绍
要解决的问题
跑数据库迁移时最常见的困境:CLI 用法散落在若干在线文档里,CI 机器没有外网,或者网络策略只允许内部镜像。等到真正执行 migrate 时,往往已经花了大把时间在「查文档—试错—再查」的循环里,而数据库可能已经处于半迁移状态。另一个问题更隐蔽:迁移成功后,历史表里记了什么、脚本从哪个目录解析进来、方言是否真的匹配,这些事实常常只存在于操作者的记忆里,下一个人接手只能重新猜。
技能如何工作
这套技能把 Flydb 独立 CLI 发行包的全部参考文档打包在 references/ 下,命令参数、配置键、错误码、驱动解析规则都在里面,复制到任何目录都能独立工作。三条核心契约约束行为:只用自带文档回答命令与配置问题;bin/flydb --help 的实际输出优先于参考文本;任何写库动作都要求明确授权。
工作流分四步:
- 环境预检:先确认 Java 8+ 与发行包是否就位,缺一即停。发行包依次按已有安装、本地 ZIP、GitHub Release、Gitee 镜像的顺序探测。
- 建立执行上下文:执行命令前先记录 CLI 路径、配置文件来源、脱敏后的 JDBC URL、迁移脚本位置、目标数据库与方言标识,以及这是哪个环境。
- 选择命令:按用户目标映射到
init、info、validate、migrate、baseline、repair、undo、clean,参数语义查references/commands.md,不确定时直接看--help。 - 执行与验证:只读任务执行完即停并报告退出码。迁移任务先
validate暴露 checksum 与命名问题,再--dry-run migrate核对方言、脚本集合与 SQL 顺序,拿到授权后才实际写入,最后用info和validate复核状态与失败记录。
适用边界与注意点
技能只覆盖 Flydb CLI 自身行为,不涉及服务端配置管理。参考副本可能滞后于已安装版本,以 bin/flydb --help 为准执行,并把差异报告给用户。
几个容易踩的点:不要把源码目录当成已安装的 CLI;clean 默认禁用,不要为了绕过 FLYDB-4003 去追加 --clean-disabled=false --force——那是防呆,不是故障;迁移失败不要自动 repair,它会改历史表;${workDate} 这类业务模板占位符报 FLYDB-2009 时用 --placeholder-replacement=false,不要随便赋默认值;新旧迁移目录要逗号并列,否则已应用记录会变 MISSING(FLYDB-2003);JDBC URL 一律脱敏,密码不进入命令历史、日志或 SQL。
使用场景
- CI 构建机无外网,需要用自带 references/ 离线执行 Flydb 迁移,按预检、dry-run、授权写入
- 上线前对 filesystem:db/migration 跑 validate 与 --dry-run migrate,核对方言、脚本集与 SQL 顺序
- 存量库首次纳入 Flydb 管理,生成 flydb.conf、用 baseline 写基线历史,并确认生产写入授权
- 迁移状态出现 MISSING/FLYDB-2003 或 FLYDB-1003 时,按 references/errors.md 与 drivers.md 定位后再处理
适合人员
- 后端工程师,需要按预检、dry-run、授权顺序把 Flydb 迁移安全落到预发/生产
- 后端工程师,在 CI/离线环境跑 Flydb 迁移,依赖自带 references/ 和镜像 ZIP 而不是外网文档
- 数据库平台工程师,需要处理 Flydb 错误码 FLYDB-xxxx、JDBC 驱动解析和 JDBC URL 脱敏
- 平台团队,想把 Flydb CLI 发行包纳入内部制品库,复制到任意目录后仍保持迁移可追溯