当前位置: 首页 > article >正文

sqldef:一款免费的数据库变更管理工具

应用程序的升级通常伴随着数据库表结构的变更,为了维护各种环境的数据库变更,我们通常需要引入 Liquibase 或者 Flyaway 这样的数据库版本控制工具。不过,这类工具通常需要绑定某种编程语言,例如 Java;这次我们介绍一个新的工具:sqldef。

sqldef 是一个用于管理数据库模式结构的工具,可以用于比较两个数据库中的表结构差异并且生成可执行的 DDL 脚本。

在这里插入图片描述

sqldef 提供了命令行工具、WASM、NodeJS 等运行方式,支持的数据库包括 MySQL、PostgreSQL、SQLite 以及 SQL Server。

下载安装

sqldef 支持跨平台,包括 Linux、Windows、macOS。输入以下网址可以下载编译好的二进制文件:

https://github.com/sqldef/sqldef/releases

基于不同的操作系统和数据库下载对应的文件,例如 Windows 平台的 MySQL 数据库,文件名为 mysqldef_windows_amd64.zip。下载完成后解压得到可执行文件 mysqldef.exe。

PostgreSQL 对应的文件名为 psqldef_xxx,SQLite 对应的文件名为 sqlite3def_xxx,SQL Server 对应的文件名为 mssqldef_xxx。

使用案例

下面我们以 MySQL 数据库为例,演示以下如何使用 mysqldef:

# 确保 mysql 客户端可以连接数据库
PS C:\Users\bell-> mysql -uroot -p test -e "select 1;"
Enter password: ********
+---+
| 1 |
+---+
| 1 |
+---+

# 使用 mysqldef 工具导出数据库 test 的表结构
PS C:\Users\bell-> .\mysqldef.exe /u root /p xxxxxx /export test
CREATE TABLE `user` (
  `id` bigint unsigned NOT NULL AUTO_INCREMENT,
  `name` varchar(128) DEFAULT 'NA',
  PRIMARY KEY (`id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_0900_ai_ci;

# 保存表结构到文件
PS C:\Users\bell-> .\mysqldef.exe /u root /p xxxxxx /export test > mysql_test.sql

其中,/u 用于指定用户名;/p 用户指定密码,需要将 xxxxxx 替换为实际值; /export 表示导出表结构;test 是数据库名称。更多的参数介绍可以通过帮助信息查看:

PS C:\Users\bell-> .\mysqldef.exe /help
Usage:
  C:\Users\bell-\mysqldef.exe [OPTIONS] [database|current.sql] < desired.sql

Application Options:
  /u, /user:user_name               MySQL user name (default: root)
  /p, /password:password            MySQL user password, overridden by $MYSQL_PWD
  /h, /host:host_name               Host to connect to the MySQL server (default: 127.0.0.1)
  /P, /port:port_num                Port used for the connection (default: 3306)
  /S, /socket:socket                The socket file to use for connection
      /ssl-mode:ssl_mode            SSL connection mode(PREFERRED,REQUIRED,DISABLED). (default: PREFERRED)
      /ssl-ca:ssl_ca                File that contains list of trusted SSL Certificate Authorities
      /password-prompt              Force MySQL user password prompt
      /enable-cleartext-plugin      Enable/disable the clear text authentication plugin
      /file:sql_file                Read desired SQL from the file, rather than stdin (default: -)
      /dry-run                      Don't run DDLs but just show them
      /export                       Just dump the current schema to stdout
      /enable-drop-table            Enable destructive changes such as DROP (enable only table drops)
      /skip-view                    Skip managing views (temporary feature, to be removed later)
      /before-apply:                Execute the given string before applying the regular DDLs
      /config:                      YAML file to specify: target_tables, skip_tables, algorithm, lock
      /help                         Show this help
      /version                      Show this version

打开生成的 mysql_test.sql 文件,增加一个字段 created_at 和索引 index_name:

CREATE TABLE `user` (
  `id` bigint unsigned NOT NULL AUTO_INCREMENT,
  `name` varchar(128) DEFAULT 'NA',
  `created_at` DATETIME NOT NULL, -- 增加一个字段
  PRIMARY KEY (`id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_0900_ai_ci;

-- 增加一个索引
CREATE INDEX user_name_idx USING BTREE ON test.`user` (name);

然后就可以运行 mysqldef 比较修改前后的表结构差异:

PS C:\Users\bell-> .\mysqldef.exe /u root /p xxxxxx /dry-run /file mysql_test.sql test
-- dry run --
ALTER TABLE `user` ADD COLUMN `created_at` datetime NOT NULL AFTER `name`;
CREATE INDEX user_name_idx USING BTREE ON test.`user` (name);

其中,/dry-run 表示只显示要执行的 DDL,但是不会实际执行。

我们去掉 /dry-run 参数,针对数据库执行差异 DDL:

PS C:\Users\bell-> .\mysqldef.exe /u root /p xxxxxx /file mysql_test.sql test
-- Apply --
ALTER TABLE `user` ADD COLUMN `created_at` datetime NOT NULL AFTER `name`;
CREATE INDEX user_name_idx USING BTREE ON test.`user` (name);

此时,数据库中已经应用了最新的 DDL,修改表结构。再次执行以上命令:

PS C:\Users\bell-> .\mysqldef.exe /u root /p root2024 /file mysql_test.sql test
-- Nothing is modified --

显示数据库结构没有更改。

其他数据库的示例可以参考 GitHub 上的项目文档:

https://github.com/sqldef/sqldef?tab=readme-ov-file


http://www.kler.cn/a/586380.html

相关文章:

  • rpmlib(SetVersions) is needed by can-uilts-v2019.00.0-alt1.aarch64
  • Java序列化
  • Yolo-Uniow开集目标检测本地复现
  • 基于微信小程序开发的宠物领养平台——代码解读
  • QT编程之QGIS
  • SQLAlchemy系列教程:批量插入数据
  • 卷积神经网络 - 一维卷积、二维卷积
  • 适合企业内训的AI工具实操培训教程(37页PPT)(文末有下载方式)
  • 基于6自由度搬运机器人完成单关节伺服控制实现的详细步骤及示例代码
  • opencv-显示图片
  • Mybatis语法bug
  • DeepSeek linux服务器(CentOS)部署命令笔记
  • React面试(二)
  • C语言基础知识04
  • 人工智能与人的智能,改变一生的思维模型分享【4】决策树
  • 有效的括号 力扣20
  • fprintf() 函数:C语言中的文件格式化输出利器
  • 机器学习_交叉验证
  • 大语言模型基础之‘显存优化‘
  • 【2025】Electron Git Desktop 实战一(上)(架构及首页设计开发)