# 文件存至 MOI 卷后并导入 MOI 表

读取 Catalog 文件，将其中的表格数据导入指定 MatrixOne 数据库和表。

适用于已经保存到 MOI 卷的表格文件。上游已经返回结构化 `rows` 时，可直接使用[存至 MOI 表](../data-io/save-table.md)。

## 配置文件和目标

| 配置 | 说明 |
| --- | --- |
| S3 路径 `base_path` | 必填，用于定位待导入文件的 Catalog/S3 基础路径 |
| 文件 `file_ids` | 必填，待导入的 Catalog 文件 ID 数组 |
| 数据表 | 必填，目标表名 |
| MatrixOne 数据库 | 必填，目标数据库名称 |
| 覆盖目标表 | 默认关闭；开启会在导入前清空目标表 |

先将文件上传到 MOI 卷，再将对应的文件 ID 绑定到 `file_ids`。

## 配置表格格式

CSV 可设置字段分隔符、行分隔符和引号字符；留空分别使用逗号、换行符和双引号。Excel 可指定工作表名称，留空使用活动工作表。

“起始行”表示跳过的文件起始行数。如果上游使用 `rows` 与 `columns` 保存 CSV，第一行为表头，应填 1。

覆盖会清空目标表；需要保留原记录时保持关闭，并确认文件字段与目标结构一致。

## 使用输出

`total_rows` 表示导入行数，`file_count` 表示导入文件数，`table_name` 用于核对目标。运行输出还包含阶段耗时及资源使用分析，可用于排查大文件导入。

## 示例：导入工作流生成的 CSV

流程示意：存至 MOI 卷 → 文件存至 MOI 卷后并导入 MOI 表。

绑定上游 `file_ids`，填写基础路径、数据库和表名，起始行设为 1，保持覆盖关闭。完成后核对导入数量和目标表内容。

## 继续阅读

- [变量与数据传递](../../variables-and-data.md)
- [运行与调试](../../run-debug.md)