mysqldiff使用笔记

背景

手上有个项目，有三个环境:本地开发,测试环境,线上环境，历史原因怀疑数据库表字段可能出现不匹配，所以寻找合适的工具比较数据库表结构。找到了mysqldiff。

参考文档 https://www.awaimai.com/1513.html

准备工具

首先http://downloads.mysql.com/archives/utilities/下载的工具在osx 10.15上面没法安装，另寻他法。

正好手上有台windows机器，使用windows版本测试

安装

mysqldiff是MySQL Utilities中的一个脚本，默认的MySQL不包含这个工具集，所以需要独立安装。

MySQL Utilities下载地址：http://downloads.mysql.com/archives/utilities/。
Windows系统中需提前安装“Visual C++ Redistributable Packages for Visual Studio 2013”，下载地址：https://www.microsoft.com/en-gb/download/details.aspx?id=40784。
Linux系统在下载页面选择对应发行版。

语法

mysqldiff的语法格式是：

$ mysqldiff --server1=user:pass@host:port:socket --server2=user:pass@host:port:socket db1.object1:db2.object1 db3:db4

这个语法有两个用法：

db1:db2：如果只指定数据库，那么就将两个数据库中互相缺少的对象显示出来，不比较对象里面的差异。这里的对象包括表、存储过程、函数、触发器等。
db1.object1:db2.object1：如果指定了具体表对象，那么就会详细对比两个表的差异，包括表名、字段名、备注、索引、大小写等所有的表相关的对象。
接下来看一些主要的参数：

--server1：配置server1的连接。
--server2：配置server2的连接。
--character-set：配置连接时用的字符集，如果不显示配置默认使用character_set_client。
--width：配置显示的宽度。
--skip-table-options：保持表的选项不变，即对比的差异里面不包括表名、AUTO_INCREMENT、ENGINE、CHARSET等差异。
-d DIFFTYPE,--difftype=DIFFTYPE：差异的信息显示的方式，有[unified|context|differ|sql]，默认是unified。如果使用sql，那么就直接生成差异的SQL，这样非常方便。
--changes-for：修改对象。例如--changes-for=server2，那么对比以sever1为主，生成的差异的修改也是针对server2的对象的修改。意味着:
server2是待变更的数据库
--show-reverse：在生成的差异修改里面，同时会包含server2和server1的修改。

测试示例

use test;

create table test1(
    id int not null primary key,
    a varchar(10) not null,
    b varchar(10),
    c varchar(10) comment 'c',
    d int
)ENGINE=InnoDB DEFAULT CHARSET=utf8 COMMENT='test1';

create table test2(
    id int not null,
    a varchar(10),
    b varchar(5),
    c varchar(10),
    D int
)ENGINE=myisam DEFAULT CHARSET=utf8 COMMENT='test2';

不使用--skip-table-options，

PS C:\Users\Administrator> mysqldiff --server1=root:111111@172.26.33.1:3306 --server2=root:111111@172.26.33.1:3306 --changes-for=server2 --show-reverse --difftype=sql test.test1:test.test2
# WARNING: Using a password on the command line interface can be insecure.
# server1 on 172.26.33.1: ... connected.
# server2 on 172.26.33.1: ... connected.
# Comparing test.test1 to test.test2                               [FAIL]
# Transformation for --changes-for=server2:
#

ALTER TABLE `test`.`test2`
  DROP COLUMN D,
  ADD PRIMARY KEY(`id`),
  CHANGE COLUMN b b varchar(10) NULL,
  ADD COLUMN d int(11) NULL AFTER c,
  CHANGE COLUMN a a varchar(10) NOT NULL,
  CHANGE COLUMN c c varchar(10) NULL COMMENT 'c',
RENAME TO test.test1
, COMMENT='test1';

#
# Transformation for reverse changes (--changes-for=server1):
#
# ALTER TABLE `test`.`test1`
#   DROP PRIMARY KEY,
#   DROP COLUMN d,
#   CHANGE COLUMN b b varchar(5) NULL,
#   ADD COLUMN D int(11) NULL AFTER c,
#   CHANGE COLUMN a a varchar(10) NULL,
#   CHANGE COLUMN c c varchar(10) NULL,
# RENAME TO test.test2
# , COMMENT='test2';
#

# Compare failed. One or more differences found.

其中

RENAME TO test.test1
, COMMENT='test1';

是对表格的修改
Transformation for reverse changes (--changes-for=server1)下的内容是最终的效果

mysqldiff --server1=root:111111@172.26.33.1:3306 --server2=root:111111@172.26.33.1:3306 --changes-for=server2 --show-reverse --difftype=sql test.test1:test.test2 > diff.sql
可以将sql语句输出到文件

最后编辑于：2020.07.13 19:42:30