Estimate Parquet scan bytes for SELECT queries without executing them
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 |