从 CSV 文件到结果
文件留在原处,DuckLocal 原地读取。
把文件拖进来
sales.csv会成为名为sales的视图。制表符分隔的.tsv、.txt文件和 gzip 压缩的.csv.gz文件也是一样。直接对它写 SQL
表结构侧栏显示各列和推断出的类型,自动补全也认识它们。可以使用完整的 DuckDB SQL:关联、窗口函数、CTE 和
PIVOT。把答案留下来
把结果画成图表,查看每一列的分布,或者把完整结果导出为 CSV 或 Parquet。
像关联表一样关联 CSV 文件
同时打开 orders.csv 和 customers.csv,它们各自成为一个视图。一条语句就能把它们关联起来,也可以把 CSV 和 Parquet 文件、Excel 工作表或 DuckDB 数据库里的表关联在一起。
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 里转换类型。
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。导出会重新执行查询并写出全部行。
相关页面: 本地数据分析 · Parquet 查看器 · DuckDB GUI · 用 SQL 查询 Excel · 用 SQL 查询 JSON