跨源映射

跨源映射声明两张物理表及其字段表达同一份逻辑数据，查询规划时可利用另一张表构造可下推的关联查询方案。映射是双向的，独立于导出任务，不负责复制、同步数据，也不比较两端的数据水位。

前置条件与入口

进入“平台管理 → 元数据管理 → 跨源映射”。当前账号需具备跨源映射菜单及相应操作权限，配置关系还需要两端表的管理权限；查询实际采用目标表时仍会校验查询权限。

两张表应位于当前集群、不同数据源，已完成元数据采集。可使用物理外表或 AIR 内表，不能使用逻辑视图。配置前应确认两端完整字段结构及业务数据一致性。

配置字段关系

1. 点击“新建映射”，分别选择表 A 和表 B。
2. 在字段映射中，以表 A 为基准逐项选择表 B 对应字段。系统忽略大小写填充唯一同名字段，未匹配项需人工确认。
3. 确认两端所有字段均完整、一一对应，且业务含义一致。字段旁的序号表示原表位置，不决定映射关系。
4. 点击“保存”暂存配置，新建记录默认停用；验证数据和字段后可使用“保存并开启”。编辑已有记录时，“保存”保留原启用状态。

字段名不同可通过 AS 恢复原名称，类型不同可通过 CAST 适配原查询类型。转换能力取决于实际执行的数据源，不保证任意值都能转换成功。字段数量不一致、重复对应或缺失字段时，不能保存完整显式映射。

例如，两表字段顺序不同，可以声明如下关系：

表 A 字段	表 B 字段	适配
id INTEGER	order_key BIGINT	将 order_key 转回 INTEGER，输出名恢复为 id
label VARCHAR	order_text VARCHAR	输出名恢复为 label

验证是否参与查询

1. 在启用前对两表进行业务数据核对，包括关键字段、数据范围和代表性结果。
2. 用涉及相关表的关联查询执行 EXPLAIN，检查执行计划中的 Table Mapping 信息及实际访问的表。
3. 比较使用映射前后的结果，并检查目标数据源的访问权限、类型转换及关联下推能力。

映射已开启不表示所有查询都会改用另一张表。当前仅选择参与成功下推关联的候选，不强制切换单表查询；没有可用方案时沿用原路径。目标存在额外行过滤或脱敏时不会被选中。数据写入、投影构建和导出作业不使用该映射。

管理与异常处理

列表展示关系、启用及生效状态、创建和修改时间。表或字段失效时检查两端元数据及保存的字段关系；显式映射失效会跳过替换，不按字段位置兜底。历史未配置显式字段的关系仍按位置对应，重新编辑保存后应核对显式映射。

停用或删除影响后续查询规划，不撤销已生成的执行计划；删除只移除关系，不删除两端表或业务数据。批量操作出现部分失败时，检查失败原因、权限及并发修改后重试。若提示版本冲突，应刷新记录后重新确认配置。

与导出任务及升级的关系

导出开始、失败、停用或删除均不会自动暂停手动映射，应由管理员根据数据状态决定是否启用。需要先完成数据写入的场景，见数据导出。

2.31 不再使用历史由导出任务托管的副本映射。升级前盘点需要保留的关系，核对完整字段和数据后重新登记为手动映射并验证；不能仅凭旧任务成功状态自动开启。未迁移时查询回退至原表，执行方式和性能可能变化。