duckdb-parquet-tools

August 9, 2025 ยท View on GitHub

Apache Parquet format tools for DuckDB.

Hacking duckdb-parquet-tools

Install

To build

$ mvn package

$ export PATH=$PATH:`pwd`/target/appassembler/bin

$ duckdb-parquet-tools --help
USAGE
  duckdb-parquet-tools [-hV] [COMMAND]

OPTIONS
  -h, --help      Show this help message and exit.
  -V, --version   Print version information and exit.

COMMANDS
  convert              Convert input Parquet file to DuckDB as Parquet file.
  create               Create DuckDB table and write as Parquet file.
  dbml                 Describe Parquet file as loaded by DuckDB in DBML format.
  describe             Describe Parquet file columns as loaded by DuckDB.
  head                 Write the first n records from a Parquet file in JSON format.
  meta                 Query the metadata of a Parquet file as loaded by DuckDB.
  ratios               Show data compression ratios from a Parquet file as loaded by DuckDB.
  schema               Query the internal schema of a Parquet file as loaded by DuckDB.
  help                 Display help information about the specified command.
  generate-completion  Generate bash/zsh completion script for duckdb-parquet-tools.

Installing duckdb-parquet-tools via Homebrew

duckdb-parquet-tools is available in Homebrew via the homebrew-parquet-tools tap, https://github.com/heuermh/homebrew-parquet-tools

$ brew tap heuermh/parquet-tools
$ brew install duckdb-parquet-tools