连接器、导入与导出任务¶

使用 connector 查询和管理连接器、预览文件、创建导入任务和查询导出任务。连接器和任务都属于当前工作区。

moi-cli -o connector list
moi-cli -o connector tasks
moi-cli connector --help

创建与跟踪任务¶

要完成的事	使用命令	操作说明
查看或验证连接器	`get`、`validate`	创建任务前确认连接器可用。
预览文件	`preview-file`	确认待处理文件和内容范围。
创建导入或导出任务	`create-task`、`create-export-task`	复杂配置使用该子命令已确认的 `--json` 或 `--json-file`。
查询任务状态	`get-task`、`task-runs`、`export-task-state`	保存连接器和任务 ID；提交成功不表示任务已完成。

删除、重试和恢复前先读取最新任务状态。网络超时后不要直接重复提交任务，先查询原任务是否已经创建或正在运行。

要完成的事	使用命令	操作说明
浏览数据库来源	`db-list-databases`、`db-list-schemas`、`db-list-tables`、`db-source-schema`	从数据库到表逐层确认来源。
浏览结构化来源	`structured-sources`、`structured-source-databases`、`structured-source-schemas`、`structured-source-objects`、`structured-source-schema`	逐层确认对象；`structured-backfill-start-resolve` 用于解析回填起点。
确认 MatrixOne 目标表	`mo-database-list`、`mo-database-table-list`、`mo-check-table-name`	写入前确认目标数据库和表。
生成或检查列映射	`mo-column-mapping`	映射和回填参数只通过该命令已确认的 `--json` 或 `--json-file` 提供。

要完成的事	使用命令	操作说明
下载、读取或删除连接器文件	`file-download`、`file-stream`、`file-delete`	删除前先读取当前文件状态。
管理导入任务	`update-task`、`update-task-from-spec`、`delete-task`、`pause-task`、`resume-task`、`task-files`、`task-runs`、`retry-task-files`	操作前保存任务 ID、目标卷或文件信息。
管理导出任务	`export-tasks`、`export-task-info`、`export-task-files`、`create-export-task`、`retry-export-task`、`export-task-state`、`delete-export-task`	更新或删除前查询当前任务状态；删除不会撤销已写入目标系统的数据。

最后更新于 2026 年 9 月 28 日