结构同步与数据模型对比功能不同:前者直连数据库生成可执行DDL脚本,后者比对.ndm模型文件仅输出逻辑变更建议;模型对比需设活动模型、勾选物理属性等选项,生成SQL不可直接执行,生产变更必须经结构同步验证。

结构同步 vs 数据模型对比:别混淆这两个功能
Navicat Premium 17 的「数据模型对比」不是结构同步的入口,它属于 Data Modeler 模块,用于比对两个物理数据库导出的模型文件(.ndm),而非直接连接数据库实时比对。如果你点开的是「工具 → 结构同步」,那走的是在线比对路径;如果是在「模型」工作区里右键两个模型选「Compare Models」,才是真正的模型对比。两者生成的 SQL 类型和适用阶段完全不同:前者产出可执行的 ALTER/DROP/CREATE 脚本,后者只生成逻辑层变更建议,需手动确认是否映射到物理库。
用模型对比生成差异SQL的完整流程
前提是你已通过「逆向工程」从源库和目标库分别生成了两个 .ndm 模型文件。操作时注意以下关键点:
- 必须在同一个 Navicat Data Modeler 工作区中打开两个模型,且目标模型要设为「Active Model」(右键 → Set as Active Model)
- 「Compare Models」弹窗中勾选
Compare physical properties,否则不会比对字段长度、字符集、存储引擎等实际影响 DDL 的细节 - 默认不比较索引和外键约束,如需包含,需手动勾选
Indexes和Foreign Keys—— 这直接影响最终 SQL 是否含ADD INDEX或ADD CONSTRAINT - 比对结果页点击
Generate Synchronization Script,生成的是「从当前活动模型同步到另一个模型」的脚本,方向不可逆,务必确认谁是源、谁是目标
生成的SQL为什么不能直接执行?常见坑点
模型对比生成的脚本默认不含事务控制、无条件判断,也不做兼容性检查,直接运行可能失败:
-
ALTER TABLE ... MODIFY COLUMN在 MySQL 8.0+ 中被弃用,但模型对比仍可能生成它;应手动替换为CHANGE COLUMN或MODIFY COLUMN(取决于是否改列名) - 若源模型有
ENUM('a','b'),目标模型是ENUM('a','b','c'),脚本会生成MODIFY COLUMN type ENUM('a','b','c'),但 MySQL 要求该操作必须重建表,而 Navicat 不提示或加ALGORITHM=INSTANT条件 - 脚本默认不处理权限、注释、分区定义等非核心结构项,这些在「Compare Options」里需单独开启,否则差异会被忽略
- 生成的 SQL 文件编码默认为系统 locale(如 Windows-1252),若含中文注释,导入时容易乱码,建议保存前手动改为
UTF-8 with BOM
真正稳妥的变更落地方式
模型对比适合设计评审和变更预演,但生产环境变更必须过结构同步这一关:
- 先用模型对比确认逻辑层差异,导出报告给 DBA 审核
- 再用「工具 → 结构同步」直连两个数据库,启用
模拟运行(Simulate Execution)功能——它会真实连接目标库,检查字段是否可修改、索引是否存在、外键依赖是否满足,并标红高风险操作(如DROP COLUMN) - 结构同步生成的脚本自带
BEGIN TRANSACTION/COMMIT,且支持分段执行(如只同步某几张表),这才是能进 CI/CD 流水线的输出
模型对比是画图纸,结构同步才是动焊枪。图纸画得再准,不验钢号、不测承重,就上工地,迟早出事。


















