【小白使用视角】coze多维表格插件分页读取数据系统性介绍

前言

1. coze知识文档搭建的初衷：本人作为小白，实践学习AI和coze等工作流已有大半年的时间，深知作为一个小白从零开始学习的难度不小，并且本人搜索了全网各平台，对coze平台底层原理性介绍、具体详细操作介绍的视频和文档少之又少，但是coze中很多插件又缺乏详细具体使用的介绍，所以结合本地近半年大量的实践经验，希望能够整理一份系统性的coze工作流的知识库文档，并且免费开源供大家使用。

2. coze知识文档搭建的期望：本人期望利用业余时间搭建一个入门小白视角可以使用的、系统性的coze知识文档，已经在持续更新中，具体规模大小还不确认，也许1万字？也许5万字？（先给自己定一个小目标哈哈哈🤣）总而言之，就是希望将自己实践的经验，可以开源分享给大家使用，大家也可以评论或添加我的微信，一起讨论更好的coze使用的方案

本文档仅为其中一小部分的介绍，为了方便大家咨询问题、讨论或者获取更多coze教程，也可以添加我的微信，希望可以和大家一起共建一个coze讨论社区！！

微信：xiaoxiongAI25

文档原始飞书文档链接：【小白使用视角】coze多维表格插件分页读取数据系统性介绍

文档正式内容：

---

一、为什么要使用分页读取

1. 多维表格读取数据有上限。多维表格插件一次最多可以读取500条数据，如果超过500条数据那么就无法读取得。到。

2. 一次性读取多维表格数据过多可能存在乱码的情况。在实践过程中，发现过如果多维表格存储的字段比较多，且一次性读取的记录数较多（超过100条），那么有可能会存在乱码的情况

二、分页读取多维表格的原理

三、分页读取多维表格工作流

大家可以把工作流上面原理流程图放在一起来看，会更容易理解！！

注：大家仔细对比了之后会发现，会存在一些差异，在工作流中使用了两次多维表格插件。这是因为循环体的中间变量page_token为必填项，但是我们又不知道起始的page_token是多少，所以就在循环体前使用了一次多维表格插件，获取第一条记录的page_token，然后传给循环体，所以循环体就会从第二条数据开始循环分页读取数据。

⚠️这里会存在一些小小问题，就是第一个多维表格读取的第一条数据，后续无法使用。所以这里有一个小小的技巧就可以解决：把第一条记录的值按照相同的数据结构随便造一条记录即可（因读取第一条记录仅为获取page_token），真实全部的数据，从第二条记录开始，这样就可以顺利读取所有需要的数据啦！

四、分页读取多维表格详细操作

步骤	说明	示例
配置初始读取多维表格的插件	在初始配置的多维表格插件中，page_size配置为1，其他的不需要配置，主要目的是为把初始位置的page_token传给下一个循环节点。所以一般多维表格第一条记录，按照对应的数据类型随意配置，把正式需要读取的数据放在第二条记录集以后
配置循环节点	配置循环的模式为“无限循环”，意思是一直会循环下去，通常需要配合【选择器】，来设置中止循环的条件，后续会详细说明； 配置一个中间变量，用于每次循环的时候，获取上一次循环的page_token，然后传递到循环体内 配置一个输出变量，以便把循环读取的数据结构，用于后续节点的处理
配置循环体内的多维表格插件节点	配置page_size，根据实际需求情况配置即可，我这里示例是每次读取2条记录； 配置page_token，把循环节点中间变量的page_token传递到多维表格插件，这样就是这次是从哪一条记录开始读取
【⚠️重点核心逻辑】配置【设置变量】节点，实现page_token的循环传递	循环体里面多维表格节点读取数据后，会生成该次读取的记录中最后一条记录的page_token； 这个page_token的值传递给【设置变量】节点，然后【设置变量】节点会把这个值，再传递给循环节点的“中间变量”； 在上一步，多维表格插件节点已经配置接收了循环节点的“中间变量”的值，这样page_token每次循环的时候，就可以记录这次读取到多维表格哪一行记录了，并且把这个记录传递给下一次循环，这样下一次循环就知道从哪一行记录开始读取，这样就实现了分页循环读取多维表格数据。
配置【选择器】节点	前面说过了，循环节点是使用的无限循环，需要搭配【选择器】来判断条件，然后中止循环。我们判断的条件就是hash_more，意思就是是否还剩下要读取的数据，如为true则继续循环；如为false，则终止循环（搭配终止循环节点）

五、总结

通过上面的步骤，大家就可以实现循环读取多维表格数据啦！！核心逻辑为通过page_token来标识每次读取到了哪一行记录，并且记录page_token的值，然后传递给下一次读取，下一次读取就知道从哪开始读取，这样就实现了循环读取多维表格数据。再搭配hash_more来判断什么时候终止循环，就可以正常运行工作流啦！！

如果大家还有什么问题，可以添加微信提问。