导入任务¶
将本地文件、连接器文件或外部数据库表导入目标数据表，并跟踪任务、文件和运行记录。本页只涵盖导入任务；选择外部数据库来源和列映射时，请先参阅浏览连接器数据源。
前提条件¶
准备可访问目标工作区的凭据，以及目标数据表所需的已有资源。有关服务地址、认证和通用请求格式，请参阅调用前准备。
从连接器导入时，需要已有连接器标识；从本地导入时，使用本地上传并创建任务的动作。结构化载入前，先确认来源表、目标表和列映射。
调用顺序¶
根据来源选择创建方式：使用已有文件时创建任务；使用本地文件时上传并创建任务；从数据库表载入时创建结构化载入任务。
保留任务标识，并查询任务详情、任务文件和运行记录，区分任务配置、文件处理情况和每次运行情况。
需要调整任务时更新任务；需要暂时停止处理时暂停任务，继续处理时恢复任务。
文件失败时先查询运行记录和文件信息，再重试失败文件。确认不再需要任务后再删除。
API 操作¶
创建和配置任务¶
要完成的事 |
API 操作 |
何时使用 |
|---|---|---|
创建任务 |
使用已有来源文件创建导入任务时使用。 |
|
本地上传并创建导入任务 |
从本地文件开始导入时使用。 |
|
创建数据库结构化载入任务 |
从连接器数据库表载入数据时使用。 |
|
导入任务对象字段 |
需要理解任务对象的公共字段时查阅。 |
|
更新任务 |
需要调整已有任务时使用。 |
跟踪和处理任务¶
要完成的事 |
API 操作 |
何时使用 |
|---|---|---|
查询任务列表 |
查找任务或确认任务仍在列表中时使用。 |
|
查询任务详情 |
查看单个任务的当前配置和状态时使用。 |
|
查询任务文件 |
检查任务关联文件及其处理情况时使用。 |
|
查询运行记录 |
检查每次运行的记录时使用。 |
|
暂停任务 |
需要暂时停止任务时使用。 |
|
恢复任务 |
需要继续已暂停任务时使用。 |
|
重试失败文件 |
已确认文件失败并需要重新处理时使用。 |
删除任务¶
要完成的事 |
API 操作 |
何时使用 |
|---|---|---|
删除任务 |
确认不再需要该任务后使用。 |
结果确认¶
创建、更新、暂停或恢复后，使用查看导入任务详情确认任务当前状态；使用查看导入任务文件列表和查看导入任务运行记录列表检查处理结果和失败信息。
限制和注意事项¶
创建任务表示请求已提交；文件和运行记录是确认实际处理情况的入口。
重试失败文件前，先检查对应任务文件和运行记录中的失败信息。
删除任务前确认不再需要继续查询或处理其关联文件。