Budibase 数据导出实操指南:3种格式怎么选?一键筛选字段+定时自动导出
2026/9/4 9:42:21 网站建设 项目流程

Budibase 数据导出实操指南:3种格式怎么选?一键筛选字段+定时自动导出

【免费下载链接】budibaseAI agents, automations and apps that run your operations. Model agnostic.项目地址: https://gitcode.com/GitHub_Trending/bu/budibase

周五下午,隔壁工位发来一句"把上周新增的客户数据发我一下"。如果是手工系统,你得逐列复制、对齐表头,再祈祷对方 Excel 不乱码。在 Budibase 里这件事的时长大约是 30 秒:打开对应应用的表格视图(Grid View),点右上角的 Export 按钮,选格式,文件直接落到本地。导出的入口在后端由 exportRows 接口 承接,前端点的每个选项最后都会变成这个请求里的一个参数。

场景一|"把数据发我"的临时需求

这是最常见的场景:老板要周报素材、运营要活动名单、财务要月度对账。

操作路径固定:左侧导航进入你的数据表 → 表格视图 → 右上角Export。此时请求会带上当前视图的行和列,默认导出整表。几个可以现场调的旋钮:

  • 勾选部分行:表头左侧复选框选中要导出的行,只有被选中的rowIds会进文件;
  • 自定义列:勾选框旁边的列选择,决定哪些columns进入文件;
  • 表头翻译customHeaders可以把purchs_amt这类字段名换成业务同事看得懂的"采购金额",不用导完再改。

上面的库存表就是典型样例:8 行记录、8 个字段,点 Export 即得 CSV,直接拖进 Excel 或 Google Sheets 就能用。

场景二|数据要喂给程序,用带 Schema 的 JSON

发给人的数据用 CSV 最省事;数据要给程序再导回 Budibase 或别的系统时,选JSON (with schema)。这个格式会把字段类型定义(schema)和行数据一起打包——schema对象里保留每个列的类型信息,rows数组装数据。这样导入端不用猜哪列是日期、哪列是附件,还原表格结构时零摩擦。

三种格式的生成逻辑都在 view/exporters.ts 里,一共就三个函数:csvjsonjsonWithSchema,行为很透明,出问题时看这一个文件就够了。

选型|一张表对比 3 种格式

你的去向推荐格式关键点
Excel / Google Sheets / 邮件发给同事CSV默认逗号分隔,可换分隔符;表头可自定义
API 对接、脚本处理JSON纯行数据,结构最轻
迁移到另一套 Budibase、跨环境备份JSON (with schema)字段定义随行附带,导入可还原表结构
数据里含换行符、引号CSV 也能扛引擎会自动转义引号("""),对象型字段自动转 JSON 字符串

场景三|大表只想动一小部分

表里有 5 万行,但只需要"状态 = 维修中"的 200 行?先筛选再导出,比导出后人工删行靠谱得多:

  1. 表格视图顶部的筛选栏加上条件(如StatusisRepair);
  2. 再点 Export,导出结果与当前筛选结果一致——请求体里的query参数会把筛选条件一并带上;
  3. 想按某列排序输出,先点列头排好序,sort/sortOrder会原样写进文件。

另外两个容易忽略的选项:分隔符(部分欧洲版 Excel 默认按分号解析,导出时直接改成;能省一次重开文件)和行数上限——万行级的表建议先筛后导,文件小了传输和打开都快。

场景四|设一次就忘掉:自动化与备份

如果这份名单每周一早上 9 点必须准时出现在共享目录,就不用手动点了。在 automations 模块 对应的界面里,建一条定时 Automation:触发器选固定时间,动作选"调用数据表导出",配合 Webhook 或邮件动作把文件推出去。配置一次,之后它每周一自己干活,你负责的是别的事。

⚠️ 这里要分清两个概念:行导出(rows/exportRows,导的是数据)和应用备份(backups/export,导出的是整个应用的配置+数据压缩包)。前者给业务数据流动用,后者给"我要把这套 App 整体搬去另一台服务器"的场景,别拿备份包当周报素材发。

避坑清单|这 5 件事提前知道

  1. 日期列出现奇怪格式:导出前确认该列在表里就是 Date 类型,文本型日期导出后只能按字符串处理。
  2. 嵌套对象/数组列:CSV 里会被自动转成 JSON 字符串(带引号包裹),这是引擎的既定行为,不是 bug;下游程序按 JSON 解析即可。
  3. 文件太大打不开:先筛选缩小行数,再取消勾选用不到的列,两条路都能立刻见效。
  4. 中文表头乱码:确认导出的 customHeaders 用的是你期望的编码环境,Excel 双击打开 CSV 默认按本地编码解析,必要时另存为 UTF-8 再开。
  5. 导完想导回去:JSON 带 schema 的版本能还原字段定义;纯 CSV 导回时需要走导入向导重新匹配列。

延伸探索

  • 想看导入侧怎么接:table 路由 里的bulkImportcsvToJson与导出正好成对;
  • 想让导出结果自动落到 S3 或共享盘:Automation 的动作库里找文件类动作,串在你定时导出后面;
  • 想自己搭环境玩:git clone https://gitcode.com/GitHub_Trending/bu/budibase后按仓库根目录说明启动,5 分钟就能有一条能导出的测试表。

把"发我一下数据"从周五的意外变成 30 秒的常规操作,这套流程就可以先跑起来了。

【免费下载链接】budibaseAI agents, automations and apps that run your operations. Model agnostic.项目地址: https://gitcode.com/GitHub_Trending/bu/budibase

创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询