用 SQL 查询 Excel 文件

在 DuckLocal 中打开一个工作簿,每个工作表都会变成一张表。工作表之间、工作表与 CSV 和 Parquet 文件之间,甚至与 DuckDB 数据库之间都能 JOIN,得到数据透视表给不了的答案。无需安装 Excel,无需数据库服务器,什么都不上传。

免费开源,支持 macOS、Windows 和 Linux。你的工作簿只会被读取,永远不会被修改。

从工作簿到答案

把文件拖进来,或者从菜单打开。没有需要一路点下去的导入向导。

  1. 打开工作簿

    第一个工作表会成为以文件名命名的表:budget.xlsx 得到 budget。其余工作表命名为 {file}_{sheet},例如 budget_actuals。空工作表会被跳过。

  2. 对工作表写 SQL

    表结构侧栏会列出每个工作表的列和推断出的类型,自动补全也认识它们。JOIN、窗口函数、PIVOT 以及 DuckDB SQL 的其余功能都可以用。

  3. 保留结果

    把结果画成图表,查看每一列的分布,或者把完整结果导出为 CSV(给电子表格用)或 Parquet(给其他工具用)。

联合查询工作表、工作簿和文件

跨工作表查找原本要写一堆 VLOOKUP 公式,在 SQL 里只是一个 JOIN。两个工作簿之间、工作表与其他系统导出的 CSV 之间,同样适用。

SQL 编辑器 · 用 SQL 查询 CSV

-- budget.xlsx: first sheet → budget,
-- sheet "actuals" → budget_actuals
SELECT b.department,
       b.planned,
       sum(a.amount)             AS spent,
       b.planned - sum(a.amount) AS remaining
FROM budget b
JOIN budget_actuals a USING (department)
GROUP BY b.department, b.planned
ORDER BY remaining;

工作表如何变成一张表

第一行是表头。每一列会得到能容纳其中所有单元格的最窄类型:整数为 BIGINT,整数与小数混合为 DOUBLE,日期为 TIMESTAMP,真/假值为 BOOLEAN。其他混合内容保留为 VARCHAR,不丢任何数据,你可以在 SQL 里用 TRY_CAST 转换。

工作簿导入的详细说明

  • 空单元格变成 NULL
  • 空的表头单元格变成 column_1、column_2…
  • 重复的表头会加后缀:amount、amount_2
  • 公式以计算结果的值导入
  • 工作簿文件永远不会被写入

一份可以保留的副本

CSV 和 Parquet 是在原处读取的,工作表则不同:打开工作簿时,工作表会被复制进一张表。如果你在 Excel 里改了文件,再打开一次,表就会被替换。

想把这些表留下来,就先打开一个 .duckdb 数据库,再打开工作簿。工作表会保存进这个数据库,下次打开时还在,任何 DuckDB 客户端也都能读取。

在命令行里处理工作簿

ducklocal schema 会列出工作簿及其工作表,--stats 会分析第一个工作表:每一列的空值、不同值、范围和中位数。AI 智能体可以在写任何 SQL 之前先看清电子表格里有什么。

要从脚本或智能体查询工作表,先按上面的方法在应用里把它们保存进数据库,再对该文件运行 ducklocal query --database。

阅读 CLI 指南 · 面向 AI 智能体的 SQL

Terminal
$ ducklocal schema budget.xlsx
$ ducklocal schema budget.xlsx --stats
$ ducklocal query --database budget.duckdb \
  --sql "SELECT department, sum(amount)
         FROM budget_actuals
         GROUP BY department"

关于 Excel 与 SQL

DuckLocal 能查询哪些电子表格格式?
Excel 的 .xlsx、.xls 和 .xlsb 工作簿,以及 OpenDocument 的 .ods 电子表格。每个非空工作表都会导入为一张独立的表。
DuckLocal 会修改我的工作簿吗?
不会。它读取文件,把每个工作表复制进一张表,工作簿本身永远不会被写入。之后如果你在 Excel 里编辑了它,再打开一次即可获取改动。
公式能带过来吗?
带过来的是值。DuckLocal 读取的是电子表格软件保存在文件里的计算结果,而不是背后的公式,所以一列合计会以数字的形式出现。
能把结果导出回电子表格吗?
可以把任何结果导出为 CSV,Excel 和其他电子表格软件都能打开;也可以导出为 Parquet,给其他数据工具使用。DuckLocal 不会写出 .xlsx 文件。
DuckLocal 能替代 Excel 吗?
做分析可以:跨工作表和文件的 JOIN、聚合,以及超过工作表 1,048,576 行上限的数据。它不是电子表格编辑器,你不会在单元格里输入内容或写公式。

对你自己的工作簿运行 SQL

下载 DuckLocal,拖入一个电子表格,用一条查询把它的工作表连起来。