Search Shortcut cmd + k | ctrl + k

Estimate Parquet scan bytes for SELECT queries without executing them

Maintainer(s): aleda145

Compatibility Matrix

This table covers all DuckDB releases that have not reached end-of-life, including LTS releases, and shows the 2 most recent patch releases of each. Older patch releases are not listed, but the extension may be available for them as well.

Platform 1.4.4 1.4.5 1.5.5 1.5.6 2.0.0
Linux AMD64
Linux ARM64
macOS AMD64
macOS ARM64
Windows AMD64
Windows ARM64
WebAssembly

Installing and Loading

INSTALL dryrun FROM community;
LOAD dryrun;

Example

SELECT *
FROM dryrun(
  'SELECT * FROM ''https://dryrun-data.dahl.dev/gaia-5m.parquet'''
);

About dryrun

Dryrun adds a table function for estimating Parquet scan bytes before running a query.

It parses a read-only SELECT statement, finds explicit Parquet scan sources, determines required columns, uses Parquet metadata for compressed column-chunk sizes, and applies simple row-group pruning from min/max statistics when possible.

The result reports estimated data bytes, estimated Parquet metadata bytes, files, row groups used versus total row groups, confidence, and notes (if any).

Added Functions

function_name function_type description comment examples
dryrun table NULL NULL  

Overloaded Functions

This extension does not add any function overloads.

Added Types

This extension does not add any types.

Added Settings

name description input_type scope aliases typed_value
temp_directory Set the directory to which temporary files are written. VARCHAR GLOBAL [] post.db.tmp
© 2026 DuckDB Foundation, Amsterdam NL
DuckDB Home Code of Conduct Trademark Use Blog