# 读取 MOI 表

读取 Catalog 中的 MOI 数据表，并以结构化数据行输出，供后续保存或外部请求使用。

需要筛选、聚合或连接表时，可使用[SQL 处理](../code-processing/sql-processing.md)。

## 配置读取

| 配置 | 说明 |
| --- | --- |
| 数据表 | 必选，从当前工作区 Catalog 选择，运行输入为 `table_ref` |
| 读取行数 | 可选非负整数，正数限制本次查询行数 |
| 超时秒数 | 可选非负整数，设置读取超时参数 |

通过数据表选择器取得完整的 `table_ref`，节点据此确定数据库和表名。

读取行数为 0 时，查询不附加行数限制，但返回结果仍受服务端限制。

## 使用输出

`rows` 是按列名组织的数据行对象数组，可绑定到存至 MOI 表的“数据行”。`table_ref` 保留源表引用；`database`、`table_name` 和 `sql` 用于核对读取目标。

`truncated` 表示结果是否被截断，`elapsed_ms` 表示执行耗时。返回行数只统计本次结果。

## 示例：复制少量样本

流程示意：读取 MOI 表 → 存至 MOI 表。

选择源表，将读取行数设为 100，再把 `rows` 绑定到另一个目标表。核对列名、目标表和影响行数。

## 继续阅读

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