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 里,一共就三个函数:csv、json、jsonWithSchema,行为很透明,出问题时看这一个文件就够了。
选型|一张表对比 3 种格式
| 你的去向 | 推荐格式 | 关键点 |
|---|---|---|
| Excel / Google Sheets / 邮件发给同事 | CSV | 默认逗号分隔,可换分隔符;表头可自定义 |
| API 对接、脚本处理 | JSON | 纯行数据,结构最轻 |
| 迁移到另一套 Budibase、跨环境备份 | JSON (with schema) | 字段定义随行附带,导入可还原表结构 |
| 数据里含换行符、引号 | CSV 也能扛 | 引擎会自动转义引号("→""),对象型字段自动转 JSON 字符串 |
场景三|大表只想动一小部分
表里有 5 万行,但只需要"状态 = 维修中"的 200 行?先筛选再导出,比导出后人工删行靠谱得多:
- 表格视图顶部的筛选栏加上条件(如
StatusisRepair); - 再点 Export,导出结果与当前筛选结果一致——请求体里的
query参数会把筛选条件一并带上; - 想按某列排序输出,先点列头排好序,
sort/sortOrder会原样写进文件。
另外两个容易忽略的选项:分隔符(部分欧洲版 Excel 默认按分号解析,导出时直接改成;能省一次重开文件)和行数上限——万行级的表建议先筛后导,文件小了传输和打开都快。
场景四|设一次就忘掉:自动化与备份
如果这份名单每周一早上 9 点必须准时出现在共享目录,就不用手动点了。在 automations 模块 对应的界面里,建一条定时 Automation:触发器选固定时间,动作选"调用数据表导出",配合 Webhook 或邮件动作把文件推出去。配置一次,之后它每周一自己干活,你负责的是别的事。
⚠️ 这里要分清两个概念:行导出(rows/exportRows,导的是数据)和应用备份(backups/export,导出的是整个应用的配置+数据压缩包)。前者给业务数据流动用,后者给"我要把这套 App 整体搬去另一台服务器"的场景,别拿备份包当周报素材发。
避坑清单|这 5 件事提前知道
- 日期列出现奇怪格式:导出前确认该列在表里就是 Date 类型,文本型日期导出后只能按字符串处理。
- 嵌套对象/数组列:CSV 里会被自动转成 JSON 字符串(带引号包裹),这是引擎的既定行为,不是 bug;下游程序按 JSON 解析即可。
- 文件太大打不开:先筛选缩小行数,再取消勾选用不到的列,两条路都能立刻见效。
- 中文表头乱码:确认导出的 customHeaders 用的是你期望的编码环境,Excel 双击打开 CSV 默认按本地编码解析,必要时另存为 UTF-8 再开。
- 导完想导回去:JSON 带 schema 的版本能还原字段定义;纯 CSV 导回时需要走导入向导重新匹配列。
延伸探索
- 想看导入侧怎么接:table 路由 里的
bulkImport和csvToJson与导出正好成对; - 想让导出结果自动落到 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),仅供参考