djrobstep/migra

migra：PostgreSQL schema的差异比较工具

镜像概述

migra是一个针对PostgreSQL的schema差异工具，基于Python编写并容器化。它能够自动识别两个PostgreSQL数据库schema之间的差异，并生成将源schema转换为目标schema所需的SQL迁移语句。主要用于简化数据库schema迁移流程，提升开发效率和变更可靠性。

核心功能和特性

• schema比较：自动检测两个PostgreSQL数据库schema之间的差异
• 迁移脚本自动生成：根据schema差异生成可直接执行的SQL迁移语句
• 开发数据库同步：从应用模型自动同步开发环境数据库schema
• 变更可靠性：使schema变更可测试、稳健且（大部分）自动化
• PostgreSQL兼容性：支持PostgreSQL >= 9版本（早期版本存在已知问题，优先支持较新版本）

使用场景

• 开发环境中保持数据库schema与应用模型一致
• 生成版本化的数据库迁移脚本，便于纳入版本控制系统
• 测试环境中验证schema变更的正确性
• 多环境（开发、测试、生产）之间的schema同步

使用方法和配置说明

基本使用

通过命令行比较两个PostgreSQL数据库schema并生成迁移脚本：

bash
migra <源数据库连接URL> <目标数据库连接URL>

示例：

bash
migra postgresql:///数据库A postgresql:///数据库B

输出结果将包含从数据库A schema迁移到数据库B schema所需的SQL语句，例如：

sql
alter table "public"."products" add column newcolumn text;
alter table "public"."products" add constraint "x" CHECK ((price > (0)::numeric));

Docker容器运行示例

使用Docker容器执行migra：

bash
docker run --rm migra postgresql://用户名:密码@主机:端口/源数据库 postgresql://用户名:密码@主机:端口/目标数据库

连接URL格式

PostgreSQL连接URL格式遵循标准格式：

postgresql://[用户[:密码]@][主机[:端口]]/数据库名

文档与资源

完整文档请访问：databaseci.com/docs/migra

贡献者

• https://github.com/djrobstep%EF%BC%9A%E5%88%9D%E5%A7%8B%E5%BC%80%E5%8F%91%E4%B8%8E%E7%BB%B4%E6%8A%A4
• https://github.com/alvarogzp%EF%BC%9A%E6%9D%83%E9%99%90%E6%94%AF%E6%8C%81
• https://github.com/seblucas%EF%BC%9ADocker%E6%94%B9%E8%BF%9B
• https://github.com/MOZGIII%EF%BC%9ADocker%E6%94%AF%E6%8C%81
• https://github.com/mshahbazi%EF%BC%9A%E4%BF%AE%E5%A4%8D%E4%B8%8E%E5%A2%9E%E5%BC%BA