# 存至 MOI 表

把结构化 JSON 字段或批量数据行写入 MOI 表，并返回实际影响行数。

适用于保存提取结果或复制查询结果。文件内容需要按 CSV、Excel 等格式导入时，使用[文件存至 MOI 卷后并导入 MOI 表](../other/volume-to-table-import.md)。

## 选择目标表

选择一种目标配置方式：选择现有 Catalog 数据表 `table_ref`；或配置数据库 `database_ref` 与文本表名 `table_name`。

选择现有表后，无需填写数据库和表名。使用表名模式时，可结合 `json_schema` 定义字段，复用或创建目标表。

## 选择写入数据

| 输入 | 说明 |
| --- | --- |
| JSON 数据 `raw_json` | 单个 JSON 对象，可接受上游输出的 JSON 对象字符串 |
| 字段值 `values` | 单个字段对象；与 `raw_json` 同用时，对同名字段覆盖合并 |
| 数据行 `rows` | 非空对象数组，用于批量写入 |
| 提取 Schema `json_schema` | 定义字段结构，用于写入列的解析 |

两种写入模式互斥：批量数据绑定到 `rows`；单个对象使用 `raw_json` 或 `values`。

## 使用输出

`affected_rows` 表示实际插入或更新的影响行数；`written_columns` 列出写入字段。`database` 和 `table_name` 用于确认目标，选择 Catalog 表时还会返回解析后的 `table_ref`。

运行后核对目标表、写入列和影响行数。

## 示例：保存单份合同提取结果

流程示意：信息提取 → 存至 MOI 表。

在信息提取中使用单结果模式，将 `result` 绑定到 `raw_json`，配置相应字段 Schema 和目标表。运行后在目标表中查看提取的合同字段。

## 继续阅读

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