用 SQL查询 CSV 文件

把 CSV 文件拖进 DuckLocal,它就成了一张以文件名命名的表。DuckDB 会自动识别分隔符、表头和列类型,所以马上就能 SELECT、JOIN 和 GROUP BY。不需要导入,也不需要 CREATE TABLE;电子表格打不开的大文件,同样一条查询就能处理。

免费开源,支持 macOS、Windows 和 Linux。无需账号,没有遥测。

从 CSV 文件到结果

文件留在原处,DuckLocal 原地读取。

  1. 把文件拖进来

    sales.csv 会成为名为 sales 的视图。制表符分隔的 .tsv、.txt 文件和 gzip 压缩的 .csv.gz 文件也是一样。

  2. 直接对它写 SQL

    表结构侧栏显示各列和推断出的类型,自动补全也认识它们。可以使用完整的 DuckDB SQL:关联、窗口函数、CTE 和 PIVOT。

  3. 把答案留下来

    把结果画成图表,查看每一列的分布,或者把完整结果导出为 CSV 或 Parquet。

像关联表一样关联 CSV 文件

同时打开 orders.csv 和 customers.csv,它们各自成为一个视图。一条语句就能把它们关联起来,也可以把 CSV 和 Parquet 文件、Excel 工作表或 DuckDB 数据库里的表关联在一起。

SQL 编辑器 · 结果与图表

SELECT c.region,
       count(*) AS orders,
       round(sum(o.amount), 2) AS revenue
FROM orders o
JOIN customers c USING (customer_id)
GROUP BY c.region
ORDER BY revenue DESC;

文件很多,或者不太规整

用 read_csv 把整个文件夹的 CSV 当作一张表读取。union_by_name 可以容忍各文件的列不完全一致。如果某个文件里混进了一个文本值导致类型识别失败,就把所有列按文本读入,再在 SQL 里转换类型。

一次读取多个 CSV 文件

SELECT try_cast(NULLIF(amount, 'NULL') AS DOUBLE) AS amount
FROM read_csv('data/*.csv',
              union_by_name = true,
              all_varchar = true);

查询之外的一切

查询框只是起点,下面这些让它成为一个完整的工作台。

  • .csv .tsv .txt分隔符、表头和类型由 DuckDB 自动识别
  • .csv.gzgzip 压缩的文件也能直接打开
  • data/*.csv打开所有匹配通配符的文件
  • folder/打开目录里的所有数据文件
  • 概览每一列的空值、不同值数量、范围和分布
  • 图表把结果画成柱状图、折线图、散点图、饼图和地图
  • 导出 → Parquet把 CSV 数据转成 Parquet
  • ducklocal query在终端里执行同样的 SQL,输出 JSON

CSV 文件不会离开你的电脑

在线 CSV 工具都需要先上传文件。DuckLocal 是内置 DuckDB 的桌面应用:直接从文件路径读取,不复制、不修改,也不需要账号。

聚合会作用于文件的每一行。结果表格最多显示 10 万行,导出时则写出完整结果。

  • 不用上传,也没有 DuckLocal 云服务
  • 不用安装数据库服务器
  • 无需账号,没有遥测
  • 源文件不会被修改
  • 以 Apache-2.0 开源

在命令行里查询 CSV

同一个二进制文件也能不开窗口运行:ducklocal query --sql "SELECT count(*) FROM 'sales.csv'" 会把结果以 JSON 输出,方便脚本和 AI 智能体使用。

关于用 SQL 查询 CSV

需要先把 CSV 文件导入数据库吗?
不需要。DuckLocal 会在文件之上创建一个视图,由 DuckDB 原地读取。文件不会被复制、转换或修改,移除视图也不会影响文件本身。
能在一条查询里关联多个 CSV 文件吗?
可以。打开的每个文件都是一个独立的视图,所以两个 CSV 之间的 JOIN 就是普通的 SQL。CSV 还可以和 Parquet、JSON、Excel 工作表以及 DuckDB 表关联。
DuckLocal 用的是哪种 SQL 方言?
DuckDB SQL。它接近 PostgreSQL,并增加了窗口函数、PIVOT 等分析功能,还能用 read_csv 直接读取文件。
某一列的类型识别错了怎么办?
DuckDB 根据文件的抽样来推断类型。如果某一列需要特殊处理,可以用 read_csv(..., all_varchar = true) 按文本读取,再在查询里用 try_cast 转换。
能把 CSV 文件转成 Parquet 吗?
可以。对这个视图执行 SELECT * FROM,然后选择导出 → Parquet。导出会重新执行查询并写出全部行。

对你自己的 CSV 运行 SQL

下载 DuckLocal,跟着教程用样例 CSV 操作:大约十分钟,就能从文件走到图表。