数据导出
概述
导出任务将来源表或视图的数据写入指定目标，并按配置手动执行或自动调度。来源支持数据源中的基础视图、数据空间中的逻辑视图和 AIR 内表；含参数的视图不支持导出。目标可选择数据空间中的内表，或平台支持导出的外部数据源。
导出任务仅负责数据写入与调度。需要查询时替换表时，在“平台管理 → 元数据管理 → 跨源映射”中手动配置两张物理表的双向关系；导出任务不再自动创建或维护映射。
功能入口
本章截图以 AIR 2.30 界面为例，点击图片可查看原图。截图中的旧“副本映射”列或开关在 2.31 中已移除。
点击导航栏中“数据交换”下的“数据导出”，进入导出任务管理页面。列表展示任务状态、来源路径及最近运行情况等信息。
新建与配置导出任务
1. 配置基础信息
点击右上角的“新建导出任务”，填写任务名称和描述，选择来源数据及目标数据。
- 来源数据：选择数据空间或数据源，再选择要导出的表或视图。
- 目标类型：选择“数据空间”或“数据源”，并配置目标空间或数据源、schema、目标表等信息。表目标可选择已有表或新建表，具体选项以目标支持的能力为准。
- 写入与分区配置：根据目标类型配置写入方式、文件选项或分区信息。
不同目标的写入配置如下：
| 目标场景 | 配置说明 |
|---|---|
| 表目标 | 支持“覆盖数据”或“追加数据”等目标允许的方式。覆盖替换对应写入范围内的原有数据；追加保留原有数据并写入本次导出结果。 |
| 分区表目标 | 还需配置分区字段、分区值及取值方式。写入范围受分区配置影响，不应将分区覆盖理解为总是清空整表。 |
| 文件目标 | 按目标支持的能力配置文件名称、文件格式、字段分隔符及“同名文件处理”等选项。同名文件处理可选择忽略或覆盖，与表的追加写入是不同配置。 |
追加写入不等于自动增量同步
追加写入会写入本次查询得到的数据，不会自动识别新增或变更记录，也不保证去重。需要增量导出时，应先明确来源数据的筛选范围及重复执行的处理方式。
“高级配置”使用 JSON 对象填写目标写入参数。参数是否支持及其默认值取决于目标连接器、文件格式和执行引擎。例如，文件写入可能涉及编码、标题行、空值表示、日期格式或时区配置；这些参数不能作为所有 JDBC 目标的通用配置。只填写所选目标支持的参数，不确定时保留默认配置。
2. 配置字段映射
点击“下一步”，选择要导出的字段，并配置目标字段名称、数据类型及适用的长度、精度、描述等信息。
导出可按目标能力选择字段。这里的“字段映射”用于控制数据写入，不会创建查询替换关系；跨源映射单独配置，可以为两端物理表逐字段选择对应关系。
下图为已有任务的编辑界面，新建任务也通过“字段映射”步骤完成相同配置。
3. 配置调度
点击“下一步”，选择调度方式。
| 调度方式 | 说明 |
|---|---|
| 自动更新 | 上游更新完成后自动触发。页面显示依赖的 RP；如提示自动生成全字段明细 RP，则在导出任务启用后生成。 |
| 手动更新 | 由用户点击“执行”触发导出。 |
| 自定义 | 按配置的调度周期执行。 |
下图展示已有任务编辑时选择“自动更新”的配置界面。新建任务完成配置后点击“创建”；编辑已有任务时点击“保存”。保存配置不代表本次导出已经完成，应到“更新记录”查看执行结果。
与跨源映射的关系
跨源映射现有独立指南，完整入口、配置示例、命中验证、权限及升级注意事项见跨源映射。
在“平台管理 → 元数据管理 → 跨源映射”中手动选择当前集群的两张物理表，保存后建立双向关系。新建时忽略大小写自动填充唯一的同名字段，未匹配字段需手动选择；编辑时回填已保存的字段对应关系。两端字段必须完整、一一对应且表达相同业务含义，字段顺序可以不同。名称或类型不同会自动适配原查询所需的名称和类型。字段删除、改名等导致已保存映射失效时，查询跳过替换。历史未配置字段映射的记录继续按位置对应，编辑保存后使用显式映射。
导出成功不代表映射开启。映射的启停与导出任务独立：开始导出、执行失败、停用或删除任务都不会自动暂停手动映射。管理员应根据两表数据状态决定是否开启。映射本身不执行数据同步。
跨源映射列表支持单条和批量删除，需具备删除权限并确认。启用、停用及元数据异常的映射均可删除；删除仅移除双向映射配置，不删除两端物理表和数据。删除后不再参与后续查询规划，已生成的查询计划不受影响。批量删除会报告成功与失败数量，失败项可以重试。
历史内表副本映射需核对两端当前结构、字段业务顺序和数据状态后转为手动配置，不会直接自动开启。升级前由管理员盘点需要保留的关系；未迁移关系的查询继续使用原表。
管理与查看导出任务
任务管理
任务列表及详情页提供编辑、启用或停用、执行、删除等操作，具体可用操作取决于权限和任务状态。列表支持按任务或视图搜索、筛选和排序。
列表中的“批量导入”“批量导出”用于迁移或备份导出任务配置；业务数据的导出需通过任务执行完成。任务配置的导入、导出不包含独立的跨源映射关系。
概览
概览展示任务基础信息、来源路径、目标数据、字段映射和调度配置。跨源映射状态在独立管理页面查看。
更新记录
更新记录展示每次运行的实例、任务状态、触发方式、执行队列、开始和结束时间、耗时等信息。可查看日志，并根据运行状态和权限执行重跑或停止。
导出失败时先查看此处的日志；跨源映射异常时，到跨源映射页面查看具体原因。下面的更新记录和任务依赖截图采用另一个已有任务，演示实际运行记录及依赖关系。
任务依赖
任务依赖页展示导出任务与上游投影等对象的依赖关系及状态。选择自动更新时，可结合该页面检查上游是否按预期更新。不同任务的依赖节点数量由实际配置决定。
通过 API 查询或执行导出任务，参见导出任务接口。