# 导入任务对象字段

<!-- api-contract: data-model -->

本页定义[查询任务详情](get-import-task.md)响应中的 `data.task` 与[查询任务列表](list-import-tasks.md)响应中的 `data.tasks[]`。同一字段在两个接口中的类型和含义一致。标为“仅结构化载入”的字段仅在 `config_type` 为 `3` 时可能返回。

## 基础字段

本文中，类型后的 `[]` 表示数组，例如 `string[]` 是字符串数组；字段路径中的 `[]` 表示数组中的每一项。

| 字段 | 类型 | 说明 |
| --- | --- | --- |
| `id` | string | 任务 ID。 |
| `name` | string | 任务名称。 |
| `config_type` | integer | 任务配置类型：`1` 文件导入、`2` 数据库导入、`3` 结构化载入。 |
| `source_connector_id` | string | 来源连接器 ID。 |
| `source_connector_type` | integer | 来源连接器类型代码。 |
| `connector_name` | string | 来源连接器名称。 |
| `volume_id` | string | 目标数据卷 ID。结构化数据表导入时可能为空。 |
| `volume_name` | string | 目标数据卷名称。 |
| `volume_path` | object | 目标数据卷的目录树路径。 |
| `volume_path.id_list` | string（字符串数组） | 路径各层级的 ID。 |
| `volume_path.name_list` | string（字符串数组） | 路径各层级的名称。 |
| `creator` | string | 创建任务的用户标识。 |
| `status` | integer | 任务状态：`0` 未知、`1` 进行中、`2` 暂停中、`3` 已暂停、`4` 已完成、`5` 已失败。 |
| `source_config` | object | 类型专属的来源配置。 |
| `start_at` | integer | 开始时间的 Unix 时间戳。 |
| `end_at` | integer | 结束时间的 Unix 时间戳。 |
| `created_at` | integer | 创建时间的 Unix 时间戳。 |
| `updated_at` | integer | 最后更新时间的 Unix 时间戳。 |
| `file_types` | integer（整数数组） | 文件类型筛选代码。 |
| `path_regex` | string | 文件路径筛选正则；未设置时为空字符串。 |
| `unzip_keep_structure` | boolean | 解压时是否保留目录结构。 |
| `dedup` | object 或 null | 去重配置。 |
| `dedup.by` | string（字符串数组） | 判断重复文件的依据。 |
| `dedup.strategy` | string | 重复文件处理策略。 |
| `table_path` | object | 单表目标路径。 |
| `table_path.id_list` | string（字符串数组） | 单表目标路径各层级的 ID。 |
| `table_path.name_list` | string（字符串数组） | 单表目标路径各层级的名称。 |
| `table_paths` | object（对象数组） | 多表目标路径；没有多表配置时可能省略。 |
| `table_paths[].id_list` | string（字符串数组） | 每个多表目标路径各层级的 ID。 |
| `table_paths[].name_list` | string（字符串数组） | 每个多表目标路径各层级的名称。 |
| `source_files` | string（二维字符串数组） | 来源文件信息。每项依次为连接器名称和文件 URI。 |
| `load_type` | integer | 载入方式代码。 |
| `load_results` | object（对象数组） | 各文件或表的载入结果。 |
| `load_results[].lines` | integer | 对应结果的行数。 |
| `load_results[].reason` | string | 对应结果的失败原因。 |
| `total_rows` | integer | 任务处理的总行数。 |
| `imported_rows` | integer | 已导入的行数。 |
| `success_file_count` | integer | 成功文件数。 |
| `failed_file_count` | integer | 失败文件数。 |
| `latest_rows` | object | 最近一次运行的行统计；未采集时可能省略。 |
| `latest_rows.read_rows` | integer 或 null | 最近一次运行读取的行数。 |
| `latest_rows.succeeded_rows` | integer 或 null | 最近一次运行成功的行数。 |
| `latest_rows.failed_rows` | integer 或 null | 最近一次运行失败的行数。 |
| `latest_rows.skipped_rows` | integer 或 null | 最近一次运行跳过的行数。 |
| `latest_rows.complete` | boolean | 最近一次运行的统计是否完整。 |
| `cumulative_rows` | object | 累计行统计；未采集时可能省略。 |
| `cumulative_rows.read_rows` | integer 或 null | 累计读取的行数。 |
| `cumulative_rows.succeeded_rows` | integer 或 null | 累计成功的行数。 |
| `cumulative_rows.failed_rows` | integer 或 null | 累计失败的行数。 |
| `cumulative_rows.skipped_rows` | integer 或 null | 累计跳过的行数。 |
| `cumulative_rows.complete` | boolean | 累计统计是否完整。 |
| `error_code` | string | 当前错误代码；无错误时可能为空。 |
| `error_summary` | string | 当前错误摘要；无错误时可能为空。 |
| `target_path_state` | string | 目标路径状态。 |
| `target_path_error_code` | string | 目标路径解析或校验的错误代码；没有错误时可能省略。 |
| `target_path_error_summary` | string | 目标路径解析或校验的错误摘要；没有错误时可能省略。 |

## 结构化载入字段

以下字段仅结构化载入任务可能返回。

| 字段 | 类型 | 说明 |
| --- | --- | --- |
| `structured_load_config` | JSON object | 完整的结构化载入配置。 |
| `structured_load_summary` | object | 结构化载入摘要。 |
| `structured_load_summary.source_type` | string | 来源类型。 |
| `structured_load_summary.source_object` | string | 来源对象。 |
| `structured_load_summary.target_database_id` | string | 目标数据库 ID。 |
| `structured_load_summary.target_table_id` | string | 目标表 ID。 |
| `structured_load_summary.target_table_name` | string | 目标表名称。 |
| `structured_load_summary.source` | object | 来源摘要。 |
| `structured_load_summary.source.connector_id` | string | 来源连接器 ID。 |
| `structured_load_summary.source.connector_name` | string | 来源连接器名称。 |
| `structured_load_summary.source.source_type` | string | 来源类型。 |
| `structured_load_summary.source.database` | string | 来源数据库名称。 |
| `structured_load_summary.source.schema` | string | 来源模式名称；不适用时可能省略。 |
| `structured_load_summary.source.table` | string | 来源表名称；不适用时可能省略。 |
| `structured_load_summary.source.collection` | string | 来源集合名称；不适用时可能省略。 |
| `structured_load_summary.source.object` | string | 来源对象名称；不适用时可能省略。 |
| `structured_load_summary.target` | object | 目标摘要。 |
| `structured_load_summary.target.mode` | string | 目标表模式。 |
| `structured_load_summary.target.database_id` | string | 目标数据库 ID。 |
| `structured_load_summary.target.database_name` | string | 目标数据库名称。 |
| `structured_load_summary.target.table_id` | string | 目标表 ID。 |
| `structured_load_summary.target.table_name` | string | 目标表名称。 |
| `structured_load_summary.mapping_count` | integer | 映射数量。 |
| `structured_load_summary.mapping` | JSON | 映射配置。 |
| `structured_load_summary.schedule` | JSON | 调度配置。 |
| `structured_load_summary.backfill` | JSON | 回填配置。 |
| `structured_load_summary.run_mode` | string | 运行模式。 |
| `structured_load_summary.sync_strategy` | string | 同步策略。 |
| `structured_load_summary.backfill_enabled` | boolean | 是否启用回填。 |
| `structured_load_summary.backfill_phase` | string | 回填阶段。 |
| `structured_load_summary.backfill_progress_percent` | integer | 回填进度百分比。 |
| `structured_load_summary.runtime_init_status` | string | 运行时初始化状态。 |
| `structured_load_summary.priority` | string | 计算优先级。 |
| `structured_load_summary.config_hash` | string | 配置哈希。 |
| `structured_load_summary.progress` | object | 载入进度；没有进度时可能省略。 |
| `structured_load_summary.progress.total_rows` | integer | 进度中的总行数。 |
| `structured_load_summary.progress.imported_rows` | integer | 进度中的已导入行数。 |
| `structured_load_summary.progress.progress_percent` | integer | 进度百分比。 |
| `structured_load_summary.checkpoint` | object | 检查点摘要；没有检查点时可能省略。 |
| `structured_load_summary.checkpoint.source_object_hash` | string | 来源对象哈希。 |
| `structured_load_summary.checkpoint.structured_config_hash` | string | 结构化配置哈希。 |
| `structured_load_summary.checkpoint.source_schema_hash` | string | 来源模式哈希。 |
| `structured_load_summary.checkpoint.capability_profile_hash` | string | 来源能力配置哈希。 |
| `structured_load_summary.checkpoint.order_policy_hash` | string | 排序策略哈希。 |
| `structured_load_summary.checkpoint.consistency_proof_hash` | string | 一致性证明哈希。 |
| `structured_load_summary.checkpoint.lock_owner_run_id` | string | 检查点锁的运行 ID。 |
| `structured_load_summary.checkpoint.lock_phase` | string | 检查点锁阶段。 |
| `structured_load_summary.checkpoint.lock_expires_at` | integer | 检查点锁到期时间的 Unix 时间戳。 |
| `structured_load_summary.reconcile` | object | 对账摘要；没有对账信息时可能省略。 |
| `structured_load_summary.reconcile.id` | string | 对账记录 ID。 |
| `structured_load_summary.reconcile.run_id` | string | 对账运行 ID。 |
| `structured_load_summary.reconcile.phase` | string | 对账阶段。 |
| `structured_load_summary.reconcile.status` | string | 对账状态。 |
| `structured_load_summary.reconcile.error_code` | string | 对账错误代码。 |
| `structured_load_summary.reconcile.error_message` | string | 对账错误信息。 |
| `structured_load_summary.reconcile.created_table_id` | string | 对账中新建的表 ID。 |
| `structured_load_summary.reconcile.updated_at` | integer | 对账记录更新时间的 Unix 时间戳。 |
| `structured_load_summary.reconcile.resolved_at` | integer | 对账记录解决时间的 Unix 时间戳。 |

## 结构化载入运行时字段

以下字段也是结构化载入任务专属字段。

| 字段 | 类型 | 说明 |
| --- | --- | --- |
| `structured_runtime` | object | 结构化载入运行时信息。 |
| `structured_runtime.runtime_init_status` | string | 运行时初始化状态。 |
| `structured_runtime.config_hash` | string | 配置哈希。 |
| `structured_runtime.run_status` | string | 运行状态。 |
| `structured_runtime.checkpoint_status` | string | 检查点状态。 |
| `structured_runtime.backfill` | JSON | 回填运行时信息。 |
| `structured_runtime.schema_snapshot` | JSON | 来源模式快照。 |
| `structured_runtime.mapping` | JSON | 当前映射。 |
| `structured_runtime.progress` | object | 运行时进度；没有进度时可能省略。 |
| `structured_runtime.progress.total_rows` | integer | 进度中的总行数。 |
| `structured_runtime.progress.imported_rows` | integer | 进度中的已导入行数。 |
| `structured_runtime.progress.progress_percent` | integer | 进度百分比。 |
| `structured_runtime.checkpoint` | object | 运行时检查点。 |
| `structured_runtime.checkpoint.source_object_hash` | string | 来源对象哈希。 |
| `structured_runtime.checkpoint.structured_config_hash` | string | 结构化配置哈希。 |
| `structured_runtime.checkpoint.source_schema_hash` | string | 来源模式哈希。 |
| `structured_runtime.checkpoint.capability_profile_hash` | string | 来源能力配置哈希。 |
| `structured_runtime.checkpoint.order_policy_hash` | string | 排序策略哈希。 |
| `structured_runtime.checkpoint.consistency_proof_hash` | string | 一致性证明哈希。 |
| `structured_runtime.checkpoint.lock_owner_run_id` | string | 检查点锁的运行 ID。 |
| `structured_runtime.checkpoint.lock_phase` | string | 检查点锁阶段。 |
| `structured_runtime.checkpoint.lock_expires_at` | integer | 检查点锁到期时间的 Unix 时间戳。 |
| `structured_runtime.reconcile` | object | 运行时对账信息。 |
| `structured_runtime.reconcile.id` | string | 对账记录 ID。 |
| `structured_runtime.reconcile.run_id` | string | 对账运行 ID。 |
| `structured_runtime.reconcile.phase` | string | 对账阶段。 |
| `structured_runtime.reconcile.status` | string | 对账状态。 |
| `structured_runtime.reconcile.error_code` | string | 对账错误代码。 |
| `structured_runtime.reconcile.error_message` | string | 对账错误信息。 |
| `structured_runtime.reconcile.created_table_id` | string | 对账中新建的表 ID。 |
| `structured_runtime.reconcile.updated_at` | integer | 对账记录更新时间的 Unix 时间戳。 |
| `structured_runtime.reconcile.resolved_at` | integer | 对账记录解决时间的 Unix 时间戳。 |
| `structured_runtime.last_run` | object | 最近一次运行；没有运行记录时可能省略。 |
| `structured_runtime.last_run.id` | string | 最近一次运行 ID。 |
| `structured_runtime.last_run.status` | integer | 最近一次运行的状态代码。 |
| `structured_runtime.last_run.run_status` | string | 最近一次运行的状态。 |
| `structured_runtime.last_run.error_message` | string | 最近一次运行的错误信息。 |
| `structured_runtime.last_run.row_count` | integer | 最近一次运行处理的行数。 |
| `structured_runtime.last_run.file_count` | integer | 最近一次运行处理的文件数。 |
| `structured_runtime.last_run.source_schema_hash` | string | 最近一次运行的来源模式哈希。 |
| `structured_runtime.last_run.source_object_hash` | string | 最近一次运行的来源对象哈希。 |
| `structured_runtime.last_run.structured_config_hash` | string | 最近一次运行的结构化配置哈希。 |
| `structured_runtime.last_run.trigger_id` | string | 触发器 ID。 |
| `structured_runtime.last_run.trigger_source` | string | 触发来源。 |
| `structured_runtime.last_run.workflow_execution_id` | string | 工作流执行 ID。 |
| `structured_runtime.last_run.mowl_task_id` | string | 工作流任务 ID。 |
| `structured_runtime.last_run.moi_case_id` | string | 关联案例 ID。 |
| `structured_runtime.last_run.current_phase` | string | 当前执行阶段。 |
| `structured_runtime.last_run.scheduled_fire_at` | integer | 计划触发时间的 Unix 时间戳。 |
| `structured_runtime.last_run.started_at` | integer | 开始时间的 Unix 时间戳。 |
| `structured_runtime.last_run.ended_at` | integer | 结束时间的 Unix 时间戳。 |
| `structured_runtime.last_run.created_at` | integer | 创建时间的 Unix 时间戳。 |
| `structured_runtime.last_run.updated_at` | integer | 最后更新时间的 Unix 时间戳。 |
| `mapping` | JSON | 结构化载入映射配置。 |
| `schedule` | JSON | 结构化载入调度配置。 |
| `backfill` | JSON | 结构化载入回填配置。 |
| `runtime_init_status` | string | 结构化载入初始化状态。 |
| `priority` | string | 结构化载入优先级。 |
| `config_hash` | string | 配置哈希。 |
| `structured_config_hash` | string | 结构化配置哈希。 |