执行迁移
执行前,确认配置指向预期数据库,迁移目录中也只包含本次需要部署的版本。
初始化历史表
sh
migrate create该命令幂等创建迁移历史表,不执行版本文件。 如果数据库已包含这些文件描述的变更,继续前先阅读为已有数据库建立基线。
预览并执行
sh
migrate up --dry-run
migrate up
migrate statusup 按版本顺序执行待应用迁移,并记录成功版本。重复执行不会重放已应用版本。 命令成功时可能没有输出,请通过 status 验证结果。
Dry-run 输出 SQL 或脚本计划,不执行用户迁移,但可能读取数据库历史、建立 SSH 隧道。 对于脚本,它会编译依赖而不求值,因此无法预测动态生成的 SQL。
处理较早的待执行版本
默认情况下,低于已应用版本的待执行文件会被视为乱序并跳过。 确实需要补执行时,先确认其与当前数据库结构兼容,再在配置中 启用 migrate_out_of_order。
在部署流程中执行
sh
migrate --non-interactive up
migrate --non-interactive status --output json提前注入所需环境变量以及 SSH、代理凭据。同一数据库的迁移应串行执行。 在并发、进程崩溃或隐式提交的情况下,历史记录不能保证变更恰好执行一次。