在桌面上打开并查询 Parquet 文件

Parquet 是二进制的列式格式,文本编辑器和电子表格都打不开。DuckLocal 把 .parquet 文件打开成一张表,可以浏览、筛选、用 SQL 查询,也可以导出。一切都在你的电脑上运行,文件不会上传到任何在线查看器。

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

从 .parquet 文件到答案

看一眼文件内容,不需要 Python 环境、Notebook 或集群。

  1. 打开文件

    把文件拖进窗口,打开整个文件夹,或者使用 ./data/2026-0*/*.parquet 这样的通配符。在 Mac 上可以直接在访达里双击。每个文件都会成为一个以文件名命名的视图。

  2. 看看里面有什么

    表结构侧栏列出每一列和它的类型。“概览”标签页汇总结果中的每一列:空值、不同值数量、取值范围和分布。

  3. 查询、画图、导出

    用 DuckDB SQL 筛选和聚合,把结果切换成图表,再把完整结果导出为 CSV 或 Parquet。

检查文件本身

Parquet 文件在文件尾部保存了自己的表结构、行组、压缩方式和列统计信息。DuckDB 用普通 SQL 就能读出这些内容,所以不用扫描任何数据行,就能知道文件是怎么写出来的。

数据源 · 结果、概览与图表

-- 列和类型
DESCRIBE SELECT * FROM 'trips.parquet';

-- 行组、压缩方式和统计信息
SELECT * FROM parquet_metadata('trips.parquet');

不打开应用也能预览

在 macOS 上,在访达里选中 Parquet 文件并按下空格键,快速查看会显示列和类型、前 50 行数据,以及文件尾部记录的行数、行组、压缩方式和写入程序。

预览功能随 DuckLocal.app 一起提供,不会扫描整个文件,也不会下载任何东西。了解快速查看

  • 文件在原位置读取,不会上传
  • 查询只读取用到的列
  • 源文件不会被修改
  • 无需账号,没有遥测
  • 以 Apache-2.0 开源

一个文件,或者几千个

Parquet 数据很少只有一个文件。按它存放的方式直接打开。

  • *.parquet打开所有匹配通配符的文件
  • folder/递归遍历整个目录
  • read_parquet()在 SQL 里把多个文件当作一张表读取
  • https://通过 HTTPS 查询远程 Parquet 文件
  • s3://配置之后可访问 S3 及兼容存储
  • 导出 → CSV把查询结果导出为 CSV
  • 导出 → Parquet把 CSV、JSON 或 Excel 数据写成 Parquet
  • JOIN把 Parquet 与 CSV、JSON、Excel 和 DuckDB 表关联起来

为电子表格打不开的文件而生

结果表格最多显示 10 万行,达到上限时会明确提示。聚合、筛选和关联仍然作用于整个文件,导出时会重新执行查询并写出全部行。

所以通常的做法是让 SQL 把几百万行数据归约成你要的答案,而不是一行一行往下翻。

关于 Parquet 查看器

在 Mac 上怎么打开 Parquet 文件?
安装 DuckLocal 后,在访达里双击 .parquet 文件,或把它拖进 DuckLocal 窗口。如果只想看一眼,选中文件按空格键即可快速查看。DuckLocal 需要 macOS 12 及以上、Apple 芯片。
在 Windows 或 Linux 上怎么打开 Parquet 文件?
启动 DuckLocal,把文件拖进窗口,或从“打开”菜单里选择文件。在终端里执行 ducklocal ./file.parquet 也能直接打开。
能把 Parquet 转成 CSV 吗?
可以。查询文件后选择导出 → CSV,导出会重新执行查询并写出完整结果。反过来也行:打开 CSV 文件,再导出为 Parquet。
DuckLocal 能打开多大的 Parquet 文件?
DuckDB 按列读取 Parquet,并且只读取查询用到的部分,所以在笔记本电脑上处理上千万行的文件是可行的。结果表格最多显示 10 万行,聚合则作用于整个文件。
我的 Parquet 文件会被上传吗?
不会。DuckLocal 是内置 DuckDB 的桌面应用,直接从你电脑上的路径读取文件,不需要账号,也不发送遥测数据。

打开你的第一个 Parquet 文件

下载 DuckLocal,把 .parquet 文件拖进窗口。还没写 SQL,列就已经显示出来了。