飞书多维表批量更新记录【保姆级附可用代码】

飞书多维表格对接口写入存在条数限制，当数据量超过该限制进行【新增/更新记录】时，可通过分批的方式处理。

本文以更新多维表中全量记录，将【是否处理】单选字段更新为【是】为例。

一、分页获取record_id

1. 使用【列出记录(分页)】指令，通过 page_token 循环获取数据（因示例数据有限，示例指令中分页大小仅设置为20）
2. 每次获取一页记录后，json 提取返回记录列表中的 record_id
3. 将提取数据汇总到 record_id 列表中
4. 直到 page_token 为空，全部记录均被列出完毕
5. 需注意：循环外【列出记录(分页)】指令，旨在获取 page_token 变量传入循环体内；循环内【列出记录(分页)】指令会刷新 page_token 。所 以循环体内/外，列出记录的结果变量名称须保持一致，以保证循环体外创建的 page_token 变量，在循环内被刷新后，下次循环可继续使用

该步骤可确保在数据量较大时，能够完整获取所有记录。

二、构造批量更新数据

1. 遍历 record_id 列表
2. 将每条记录生成对应的更新结构，所有待更新内容存入修改记录列表

三、按固定条数分批更新

1. 设置单次更新条数（如 500 条，因示例数据有限，示例指令中仅设置为20）
2. 根据总数据量计算更新批次数
3. 按「起始索引 + 结束索引」截取每次要更新的修改记录列表
4. 每一批调用一次【更新多条记录】

通过控制单次更新的数据量，避免触发飞书多维表格的接口上限。