# 导入任务

将本地文件、连接器文件或外部数据库表导入目标数据表，并跟踪任务、文件和运行记录。本页只涵盖导入任务；选择外部数据库来源和列映射时，请先参阅[浏览连接器数据源](connector-data-sources.md)。

## 前提条件

准备可访问目标工作区的凭据，以及目标数据表所需的已有资源。有关服务地址、认证和通用请求格式，请参阅[调用前准备](../../api-call-basics.md)。

从连接器导入时，需要已有连接器标识；从本地导入时，使用本地上传并创建任务的动作。结构化载入前，先确认来源表、目标表和列映射。

## 调用顺序

1. 根据来源选择创建方式：使用已有文件时创建任务；使用本地文件时上传并创建任务；从数据库表载入时创建结构化载入任务。
2. 保留任务标识，并查询任务详情、任务文件和运行记录，区分任务配置、文件处理情况和每次运行情况。
3. 需要调整任务时更新任务；需要暂时停止处理时暂停任务，继续处理时恢复任务。
4. 文件失败时先查询运行记录和文件信息，再重试失败文件。确认不再需要任务后再删除。

## API 操作

### 创建和配置任务

| 要完成的事 | API 操作 | 何时使用 |
| --- | --- | --- |
| 创建任务 | [创建连接器文件导入任务](../../../../reference/api/ai-studio/data-connections/import-tasks/create-import-task.md) | 使用已有来源文件创建导入任务时使用。 |
| 本地上传并创建导入任务 | [本地上传并创建导入任务](../../../../reference/api/ai-studio/data-connections/import-tasks/create-local-import-task.md) | 从本地文件开始导入时使用。 |
| 创建数据库结构化载入任务 | [创建数据库结构化导入任务](../../../../reference/api/ai-studio/data-connections/import-tasks/create-structured-load-task.md) | 从连接器数据库表载入数据时使用。 |
| 导入任务对象字段 | [导入任务返回字段](../../../../reference/api/ai-studio/data-connections/import-tasks/import-task-object-fields.md) | 需要理解任务对象的公共字段时查阅。 |
| 更新任务 | [更新导入任务](../../../../reference/api/ai-studio/data-connections/import-tasks/update-import-task.md) | 需要调整已有任务时使用。 |

### 跟踪和处理任务

| 要完成的事 | API 操作 | 何时使用 |
| --- | --- | --- |
| 查询任务列表 | [查看导入任务列表](../../../../reference/api/ai-studio/data-connections/import-tasks/list-import-tasks.md) | 查找任务或确认任务仍在列表中时使用。 |
| 查询任务详情 | [查看导入任务详情](../../../../reference/api/ai-studio/data-connections/import-tasks/get-import-task.md) | 查看单个任务的当前配置和状态时使用。 |
| 查询任务文件 | [查看导入任务文件列表](../../../../reference/api/ai-studio/data-connections/import-tasks/list-import-task-files.md) | 检查任务关联文件及其处理情况时使用。 |
| 查询运行记录 | [查看导入任务运行记录列表](../../../../reference/api/ai-studio/data-connections/import-tasks/list-import-task-runs.md) | 检查每次运行的记录时使用。 |
| 暂停任务 | [暂停导入任务](../../../../reference/api/ai-studio/data-connections/import-tasks/pause-import-task.md) | 需要暂时停止任务时使用。 |
| 恢复任务 | [恢复导入任务](../../../../reference/api/ai-studio/data-connections/import-tasks/resume-import-task.md) | 需要继续已暂停任务时使用。 |
| 重试失败文件 | [重试导入失败文件](../../../../reference/api/ai-studio/data-connections/import-tasks/retry-failed-import-files.md) | 已确认文件失败并需要重新处理时使用。 |

### 删除任务

| 要完成的事 | API 操作 | 何时使用 |
| --- | --- | --- |
| 删除任务 | [删除导入任务](../../../../reference/api/ai-studio/data-connections/import-tasks/delete-import-task.md) | 确认不再需要该任务后使用。 |

## 结果确认

创建、更新、暂停或恢复后，使用[查看导入任务详情](../../../../reference/api/ai-studio/data-connections/import-tasks/get-import-task.md)确认任务当前状态；使用[查看导入任务文件列表](../../../../reference/api/ai-studio/data-connections/import-tasks/list-import-task-files.md)和[查看导入任务运行记录列表](../../../../reference/api/ai-studio/data-connections/import-tasks/list-import-task-runs.md)检查处理结果和失败信息。

## 限制和注意事项

- 创建任务表示请求已提交；文件和运行记录是确认实际处理情况的入口。
- 重试失败文件前，先检查对应任务文件和运行记录中的失败信息。
- 删除任务前确认不再需要继续查询或处理其关联文件。

## 下一步

- [浏览连接器数据源](connector-data-sources.md)
- [导出任务](export-data.md)