
go-migrate——面向 AI 智能体的一次性审批 SQL 迁移工具
来源标题:Go-migrate – SQL migrations with one-use approvals for AI agents
go-migrate 是一款可独立运行的 CLI,也可作为库嵌入 Go 应用,用于执行带版本号的 SQL 迁移,支持 PostgreSQL、MySQL/MariaDB、SQLite、SQL Server、Oracle Database 和 IBM Db2 LUW。其特色是先预览 SQL 并生成计划(plan),部署时必须提供该 plan ID,以便在迁移锁的保护下校验计划、数据库与 schema,且每次审批仅可使用一次,适合 AI 智能体执行迁移。安装方式为 go install github.com/go-gen-ecosystem/go-migrate/cmd/gomigrate@latest。在 PostgreSQL、SQLite 和 SQL Server 上,go-migrate 与 goose 都能把迁移变更和历史记录写入同一事务;而 golang-migrate 则先记录 di
以下正文由 AI 翻译自 Hacker News 最新(原文版权归原站所有),可能存在偏差,重要内容请以原文为准。
这是一篇介绍 go-migrate 工具的文章(看起来是发布公告或 README 类内容)。你没有说明希望我做什么——是要翻译、校对、改写、总结,还是提取要点?
以下是几种常见处理方式,你选一个(或直接告诉我你的需求):
1. 中文摘要(精简版)
go-migrate 是一个 Go 编写的 SQL 迁移工具,可作独立 CLI 使用,也可嵌入 Go 应用。支持 PostgreSQL、MySQL/MariaDB、SQLite、SQL Server、Oracle、Db2 LUW。
核心卖点:
- 一次性审批(one-use approvals):
up --sql先预览将要执行的 SQL 和 plan ID,部署时用--expect-plan <id>要求迁移锁下重算的 plan ID 与审批时一致,否则报plan_changed并拒绝执行——避免审批后 SQL 被改动。 - 事务一致性:在 PostgreSQL、SQLite、SQL Server 上,迁移变更与其历史记录同一事务提交(与 goose 相同);golang-migrate 则分两步(先标记 dirty、执行、再标记 clean),需要手动
force恢复。 - 性能:基准测试(100 个迁移写入全新 SQLite,modernc.org/sqlite,WAL + synchronous=OFF,六次采样取中位数)显示默认配置下 go-migrate 分配字节最少,goose 分配次数最少;golang-migrate 受其每迁移 100KB 缓冲区影响明显。
- 无需数据库即可 lint:
migrate.Lint(dialect, opts...)。 - 丰富的文件格式:版本化 SQL、up/down 成对文件、repeatable(
R__)、Flyway 风格回调;支持 goose 注解。 - 指令:
notransaction、Context、Labels、DBMS、RunAlways、Precondition、Lint ignore、StatementBegin/End。 - 库 API:
Up/UpTo/Down/Redo、只读的Plan/Status/Validate/Lint、历史管理Repair/MarkApplied/Baseline/Tag;Migrator创建后不可变,并发安全;错误可用errors.Is与migrate.ErrorCodes判断。
2. 如果你需要的是完整中文翻译,告诉我即可,我会逐段译出(代码和命令保持原样)。
3. 我注意到原文末尾似乎被截断了("…or the YAML" 之后没有内容),如果要用于发布,这部分需要补全。
需要哪种?或者你原本想让我做的是别的(比如生成文档、检查技术准确性、写示例代码)?
(原文较长,此处译出前 6000 字,完整内容请点「打开原文」。)
正文由 探How 从来源站点 RSS 同步,内容未经改写;遇到排版缺失或需要图片、视频时请以原文为准。