DBeaver XLSX 导出实战指南
【免费下载链接】dbeaverFree universal database tool and SQL client项目地址: https://gitcode.com/GitHub_Trending/db/dbeaver
DBeaver 是一款免费开源的通用数据库工具，它的 XLSX 导出功能可以把任意查询结果直接落成能打开的 Excel 文件。表头、拆表、布尔值显示都可在导出选项里配，不用另写脚本搬数据。
🚩 场景：什么时候要把查询结果交给业务方
对面那位同事只认"xlsx"这一个后缀。你发 CSV，他回一句"数字变乱码了"；表有十几万行，他打开又说滚动卡，让你拆一下。与其从结果格里手工复制粘贴，不如把导出选项一次配好，出文件就走标准流程。
📦 能力盘点：DBeaver XLSX 导出能干的五件事
- 多结果进一个工作簿：多个查询结果各自进同一文件的不同工作表，适合拼"月度多来源对账"
- 自动拆表：按行数或按指定列的取值自动开新表，适合结果集动辄几十万行的大表
- 表头四种模式：只出列名、只出列注释、两行都要、全都不出，适合要给非技术同事看注释的报表
- SQL 留档：把产出数据的 SQL 语句写进工作簿里的独立工作表，适合数据交接与审计
- 布尔值自定义：true/false 可改成"是/否"等任意文案，适合业务口径统一后的报表
🔩 原理拆解：为什么百万行导出不卡
理解三件事，参数从哪里来就清楚了。
- 流式写入。底层用 Apache POI 的 SXSSF 工作簿，内存里只保留最近 100 行的小窗口，早写的行随时落盘。像机场传送带，前端已经在卸货，后端还在装箱，不必整仓压着货。
- 类型映射，不是一律写文本。数字列写成数值单元格，日期列套日期样式，BLOB 统一写占位符 [BINARY]。像快递分拣，不按"全是箱子"处理，数字列在 Excel 里才能直接求和。
- 硬上限让路。Excel 单表封顶 1048575 行，到阈值自动开新表继续写。像固定载重的大货车，装满就换车接着跑，不硬塞。
导出选项都对应这三套机制，常用参数长这样：
splitByRowCount = 200000 splitByColNum = 2 header = both实现代码在 plugins/org.jkiss.dbeaver.data.office/，想改行为直接看 DataExporterXLSX.java。
🏃 上手实操：把 50 万行订单表导出成 3 张工作表
- SQL 编辑器里跑完查询，在结果区右键选"导出数据"，格式选 XLSX。
- 选项里 splitByRowCount 填 200000，即每 20 万行开一张新表。
- header 选 both，前两行分别是列名和列注释。
- 勾选"导出 SQL"，语句会存进文件里的独立工作表。
- 打开成品：3 张表、表头都在、列宽已自动调过、日期列仍是日期类型，可以直接筛选排序。
📝 避坑与调优：导出前该记住的参数细节
- 单元格上限 32767 个字符，超长文本会被自动截断，超长文案先拆字段
- 1900-01-01 之前的日期写不成日期类型，只能落为文本，老数据提前有预期
- BLOB/BINARY 只写 [BINARY] 占位，真要内容得先在查询里转文本
- 超 50 万行的导出，主动调小单表行数阈值，别留默认上限让一张表扛全量
- 无图形界面（headless）服务器没有字体，列宽自动调整会自动关闭，出件后要抽查
- 布尔值默认 true/false，改成自定义文案后在 Excel 里就是文本，该列求和要小心
一句话总结：XLSX 导出 = 流式写入 + 类型映射 + 自动拆表，三个参数配好就是标准化交付。适合定期给业务供数的 DBA 和数据工程师；不适合需要复杂图表美化的场景，那些留给导出后在 Excel 里精修。
【免费下载链接】dbeaverFree universal database tool and SQL client项目地址: https://gitcode.com/GitHub_Trending/db/dbeaver
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
