🔖
coze多维表格插件分页读取数据介绍

8月20日修改

前言

🔍

1.
coze知识文档搭建的初衷：在工作流实践过程中，发现全网对coze平台底层原理性介绍、具体详细操作介绍的视频和文档少之又少，但是coze中很多插件又缺乏详细具体使用的介绍，所以结合本地近半年大量的实践经验，希望能够整理一份系统性的coze工作流的知识库文档，并且免费开源供大家使用。​

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

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

微信：xiaoxiongAI25

common.docs_name - LarkCCM_Docs_Menu_Image

文档正式内容：

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

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

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

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

画板

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

💡

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

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

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

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

步骤	说明	示例
1. 配置初始读取多维表格的插件	1. 在初始配置的多维表格插件中，page_size配置为1，其他的不需要配置，主要目的是为把初始位置的page_token传给下一个循环节点。所以一般多维表格第一条记录，按照对应的数据类型随意配置，把正式需要读取的数据放在第二条记录集以后
2. 配置循环节点	1. 配置循环的模式为“无限循环”，意思是一直会循环下去，通常需要配合【选择器】，来设置中止循环的条件，后续会详细说明； 2. 配置一个中间变量，用于每次循环的时候，获取上一次循环的page_token，然后传递到循环体内 3. 配置一个输出变量，以便把循环读取的数据结构，用于后续节点的处理