Navicat共享查询需通过On-Prem Server同步而非复制.ncx文件;模型交接唯一可信格式是人工清理后的XML文件;交接后须验证SQL安全模式、日期格式及自定义函数依赖。

共享查询不能靠复制.ncx文件迁移
Navicat 的「共享查询」是绑定在 Navicat On-Prem Server 上的对象,不是本地配置文件的一部分。connections.ncx 只存连接,不存查询内容。直接导出/导入 connections.ncx 后,你在导航栏看到的「查询」节点下仍是空的。
正确做法是让接收方登录同一台 On-Prem Server:
- 确保目标机器已安装同主版本 Navicat(如都是 v17.2),并能访问 On-Prem Server 地址(如
http://navi-server:8080) - 在 Navicat 中点击右上角用户图标 →「管理云」→ 添加该 On-Prem Server 实例(填主机、端口、凭据)
- 添加成功后,导航窗格会自动出现「On-Prem Server」节点,展开即可看到所有共享的查询、代码段、BI 工作区等
- 若查询里引用了本地连接别名(如
dvdrental_mysql_db),而新环境没有同名连接,需手动右键查询 →「编辑连接」重新绑定
模型工作区必须用 XML 文件交接,不是 .nmodel 或 .nmw
交接模型时,千万别传 .nmodel 或 .nmw 文件——前者是二进制,Git 看不出字段增删;后者是本地快照,无法重建协作上下文。团队交接唯一可信载体是导出的 .xml 文件。
导出操作必须满足三个条件:
- 右键模型工作区 →
Export Model to XML(不是「导出为 SQL」或「导出为 PDF」) - 导出前确认模型属性中设置了目标数据库版本(如
MySQL 8.0),避免 JSON 类型等兼容性问题 - XML 文件需人工清理三类噪音:外键名(改
fk_abc123为fk_order_user_id)、字段注释(补-- @desc注释行)、默认值表达式(如把CURRENT_TIMESTAMP显式写成字符串)
接收方拿到 user_service_v2.xml 后,流程是:新建模型工作区 → 逆向工程 → 选择该 XML 文件。此时生成的 .nmodel 才与源环境结构一致。
交接后必须验证三处隐性依赖
即使 XML 导入成功、查询能执行,仍可能因环境差异导致运行时失败。以下三项必须逐个检查:
-
SQL 安全模式:Navicat 默认启用 Safe Updates,执行UPDATE或DELETE无WHERE条件时会报错。交接后首次运行修改类查询前,先确认是否已关闭(工具 → 首选项 → SQL 编辑器 → 安全更新) -
日期时间字面量格式:MySQL 连接里若设了sql_mode=STRICT_TRANS_TABLES,NO_ZERO_DATE,而源查询用了'0000-00-00',就会失败。需检查连接属性 →「高级」选项卡里的 SQL Mode 设置是否同步 -
自定义函数/存储过程依赖:共享查询若调用了fn_normalize_phone()这类 UDF,它不会随查询一起迁移。必须单独确认目标库已存在该函数,或提供对应 DDL 脚本一并交接
多人同时交接时,XML 是唯一可合并的中间态
如果 A 和 B 分别在不同分支上修改了模型,他们各自导出的 a_v3.xml 和 b_v3.xml 就是可 diff、可 merge 的文本。Git 能清晰标出哪行加了字段、哪列改了类型、注释是否更新。
但一旦跳过 XML,直接把 A 的 .nmodel 拖进 On-Prem Server,再让 B 拉取并本地编辑,两人后续导出的 XML 就会包含大量随机生成的 ID 和时间戳,diff 全是噪音,根本无法判断真实变更点。
真正容易被忽略的是:Navicat 从不自动同步「模型元数据」——比如谁在什么时间改了哪个表的备注、是否启用了逻辑删除标记。这些信息只存在于 XML 的注释块或自定义属性里,交接时得靠人眼核对,工具不会提醒。


















