dbmate 轻量级数据库迁移 CLI

数据库迁移的常见痛点

当在Go、Node.js、Python等不同语言或框架间切换时，现有迁移工具（如Knex、Alembic）的迁移文件格式与框架强绑定，无法直接复用；若项目需要支持PostgreSQL、ClickHouse等多种数据库，常需为每种数据库维护独立迁移脚本，语法差异导致维护成本翻倍。

dbmate 的核心设计思路

dbmate 用三个关键能力解决上述问题：

• 框架无关性：作为独立命令行工具，迁移文件采用纯SQL编写，与任何编程语言或框架兼容，无需依赖特定运行时环境；
• 多数据库覆盖：支持PostgreSQL、MySQL、SQLite、ClickHouse、BigQuery、Spanner等主流数据库，同一份SQL迁移文件可在多种数据库间复用；
• 原子性迁移：迁移过程在数据库事务内执行，中途失败会自动回滚，避免数据不一致。

适用场景与注意点

适合需要跨语言/框架复用迁移脚本的项目，或使用小众数据库（如ClickHouse）的场景。需注意：迁移文件需遵循纯SQL规范，不支持框架特定的动态SQL生成特性；Docker部署时需配置--network=host确保数据库连接可达。