Feishu Bitable icon

Feishu Bitable

读取、写入和管理飞书多维表格数据,支持简单的文本语法筛选

读取记录

AI-generated

Summary

从飞书多维表格获取记录,支持指定输出列和筛选条件,自动分页并可限制最大行数。

Inputs

  • tableUrl (required) — 粘贴飞书多维表格的完整链接,格式如 https://xxx.feishu.cn/base/xxx?table=tblxxx。系统会自动提取 App Token 和 Table ID。
  • outputColumns — 每行填写一个列名,留空则返回所有列。列名必须与飞书表格中的列名完全一致(区分大小写)。
  • filterCondition — 每行一条筛选规则,支持语法:列名+关键词(仅包含)、列名-关键词(排除)、列名+空值(仅空)、列名-空值(排除空)、列名+非空值(仅非空)、列名-非空值(排除非空)。多个包含条件之间是 AND 关系,任一排除条件匹配则排除该行。匹配不区分大小写。
  • maxRows — 限制返回的最大记录数,0 表示不限制。用于控制数据量,避免一次性获取过多数据。
  • downloadAttachments — 开启后,会自动下载附件字段中的图片/文件,并作为二进制数据输出。方便后续节点直接使用图片。
  • attachmentColumnName — 要下载附件的列名。如果留空,会自动检测并下载所有附件类型的列。

Output shape

array

节点始终输出一个主项,包含 json(飞书 API 响应结构)与可选的 binary(附件二进制数据)。若开启 downloadAttachments 且记录含附件,binary 会作为顶层属性附加在输出项上。每个二进制键(data, data_1, …)包含 data(base64编码)、mimeType 与 fileName。

Examples

Example 1: 获取指定列、筛选后的记录

tableUrl + outputColumns + filterCondition + maxRows 组合使用。

Links

Discussion