必须将查询文件显式加入Navicat Team项目，而非仅共享连接；需右键项目→“添加现有文件”导入.navicat原生查询对象，并确保其绑定的连接已加入项目且成员有View权限，否则执行报错Connection not found。
Navicat Team 项目中怎么让成员看到并运行指定查询
必须把查询文件显式加入 team 项目，而不是只共享连接。navicat 不会自动把本地“查询”同步进项目——它只同步你手动拖入或通过「添加现有文件」导入到项目里的 .sql 文件。
操作要点：
- 右键项目 →「添加现有文件」→ 选择已保存的
.sql文件（不是导出的纯 SQL 文本，而是 Navicat 自己生成的带元数据的查询对象） - 确保该查询绑定的连接也已在项目中，并对成员开放了
View权限；否则执行时会报Connection not found - 成员在项目面板里双击该查询，就能打开、运行，但能否编辑取决于你分配的权限是否勾选
Edit
为什么团队成员导入后查不到查询名称和描述
因为 Navicat 的「导出查询」功能（菜单栏 → 文件 → 导出查询）只输出 SQL 文本，不保留名称、描述、分组等元数据。即使你导出时勾选了「包含 SQL 头部注释」，也只是写入类似 /* Query Name: 日活统计 */ 的注释块，而这个注释不会被 Navicat 自动识别为查询名称。
真正能还原名称的方式只有两种：
- 用 Navicat Team 项目原生同步（非导出/导入），此时名称、描述、分组结构全部保留
- 手动导入时，必须复制头部注释里的
Query Name，粘贴到新建查询窗口顶部的「名称」输入框中再保存
漏掉这一步，查询就变成无名 SQL 块，无法被检索、调度或复用。
跨环境迁移查询时变量和连接别名失效怎么办
Navicat 内置变量（如 ${date}、${env}）和连接别名（如 @prod_db）是本地客户端解析的，不随 SQL 文本一起生效。导出后它们只是普通字符串，目标环境没有对应变量定义就会报错或返回空值。
安全做法是：
- 所有变量替换逻辑改用 SQL 标准函数实现，比如用
CURDATE()替代${date}，用DATE_SUB(NOW(), INTERVAL 7 DAY)替代硬编码日期 - 连接别名必须删掉，改用实际数据库名或 schema 名；若需多环境适配，靠 Git 分支 + 环境配置文件管理，不要依赖 Navicat 客户端特性
- 在 SQL 开头加注释说明变量含义与替换规则，例如：
-- ${date}: 请替换为 YYYY-MM-DD 格式日期，用于 WHERE create_time >= ?
Navicat On-Prem Server 同步查询到底同步哪些内容
On-Prem Server 是唯一能真正同步完整查询对象的方案，但它同步的是「Navicat 原生查询对象」，不是 SQL 文本文件。这意味着它能保留：
- 查询名称、描述、分组路径（如
/报表/用户分析/日活统计） - 绑定的连接别名（前提是该连接也已加入项目）
- 参数化变量定义（仅限 Server 管理的变量，非客户端内置变量）
- 执行历史摘要（谁、何时、成功/失败，但不存完整结果集）
注意：它不同步变量运行时的取值、不存每次执行的完整结果集、也不同步未加入项目的本地查询。一旦某查询没被拖进项目，它就永远不在同步范围内。
