# read_parquet — DuckDB 2.0.0

No description supplied by the engine.

- Reference: /products/haybarn/functions/releases/duckdb-2.0.0/read_parquet/
- JSON: /products/haybarn/functions/api/v1/duckdb-2.0.0/functions/read_parquet.json
- Snapshot ID: duckdb-2.0.0
- Engine: duckdb v2.0.0
- Source ID: d54cbbe3df
- Binary SHA-256: 4d5d001f4b0a16c16f1bc83338153a70bec7e58f0cae0eec4b44b9b9afa0bef0
- Captured: 2026-11-06T18:35:28.343Z
- Source: https://github.com/duckdb/duckdb/releases/tag/v2.0.0
- Loaded extensions: autocomplete, core_functions, icu, json, parquet, shell

## Interpretation

- Choose a snapshot matching the target engine and build. The default is captured from the published Haybarn WASM package used by the browser playground. Historical native snapshots are also available.
- Availability is an observation in the recorded build and extension profile, not a guarantee of support in every installation or in WASM.
- Types and descriptions are declarations from duckdb_functions(). Binding can specialize result types. Null means not supplied by the catalog; do not invent defaults, optionality, argument mode, or table output columns.
- Raw parameter arrays preserve catalog order for scalar/aggregate/macro functions. Raw table arguments are alphabetical. Use callingConvention for engine-confirmed positional order and named arguments; null modes are unrecorded. Named does not mean optional. Macro defaults and special named variadic behavior are not supplied by duckdb_functions().
- Catalog examples are source material and may require data or extensions. runnableExamples contains separately verified SQL for the pinned WASM package; sample-data adaptations and guide examples are labeled separately.
- Guide annotations and recipes are separate editorial content. The browser runner always uses Haybarn WASM 2.0.0-rc12, independently of the documentation snapshot.
- All URLs beginning with / are relative to the origin hosting this document. Exports require no JavaScript, cookies, API key, or browser engine.

## Overloads

### overload-ccf7a8c8f1b22319

Kind: table. Parameter order: alphabetical-not-call-order.

```text
read_parquet(path: VARCHAR, allow_empty := BOOLEAN, binary_as_string := BOOLEAN, bound_schema := ANY, can_have_nan := BOOLEAN, column_statistics := ANY, compression := VARCHAR, debug_use_openssl := BOOLEAN, encryption_config := ANY, explicit_cardinality := UBIGINT, file_row_number := BOOLEAN, filename := ANY, hive_partitioning := BOOLEAN, hive_types := ANY, hive_types_autocast := BOOLEAN, int96_as := VARCHAR, parquet_version := VARCHAR, prefetch_strategy := VARCHAR, schema := ANY, union_by_name := BOOLEAN, utf8_validation := VARCHAR) → TABLE
```

Link: /products/haybarn/functions/releases/duckdb-2.0.0/read_parquet/#overload-ccf7a8c8f1b22319

| Argument | Catalog type | Calling mode |
| --- | --- | --- |
| allow_empty | BOOLEAN | named |
| binary_as_string | BOOLEAN | named |
| bound_schema | ANY | named |
| can_have_nan | BOOLEAN | named |
| column_statistics | ANY | named |
| compression | VARCHAR | named |
| debug_use_openssl | BOOLEAN | named |
| encryption_config | ANY | named |
| explicit_cardinality | UBIGINT | named |
| file_row_number | BOOLEAN | named |
| filename | ANY | named |
| hive_partitioning | BOOLEAN | named |
| hive_types | ANY | named |
| hive_types_autocast | BOOLEAN | named |
| int96_as | VARCHAR | named |
| parquet_version | VARCHAR | named |
| path | VARCHAR | positional (position 1) |
| prefetch_strategy | VARCHAR | named |
| schema | ANY | named |
| union_by_name | BOOLEAN | named |
| utf8_validation | VARCHAR | named |

Declared return type: unknown. Variadic argument type: none declared.
Stability: unknown. Declared side effects: unknown.

### overload-b7cd3d1a475957b5

Kind: table. Parameter order: alphabetical-not-call-order.

```text
read_parquet(path: VARIANT, allow_empty := BOOLEAN, binary_as_string := BOOLEAN, bound_schema := ANY, can_have_nan := BOOLEAN, column_statistics := ANY, compression := VARCHAR, debug_use_openssl := BOOLEAN, encryption_config := ANY, explicit_cardinality := UBIGINT, file_row_number := BOOLEAN, filename := ANY, hive_partitioning := BOOLEAN, hive_types := ANY, hive_types_autocast := BOOLEAN, int96_as := VARCHAR, parquet_version := VARCHAR, prefetch_strategy := VARCHAR, schema := ANY, union_by_name := BOOLEAN, utf8_validation := VARCHAR) → TABLE
```

Link: /products/haybarn/functions/releases/duckdb-2.0.0/read_parquet/#overload-b7cd3d1a475957b5

| Argument | Catalog type | Calling mode |
| --- | --- | --- |
| allow_empty | BOOLEAN | named |
| binary_as_string | BOOLEAN | named |
| bound_schema | ANY | named |
| can_have_nan | BOOLEAN | named |
| column_statistics | ANY | named |
| compression | VARCHAR | named |
| debug_use_openssl | BOOLEAN | named |
| encryption_config | ANY | named |
| explicit_cardinality | UBIGINT | named |
| file_row_number | BOOLEAN | named |
| filename | ANY | named |
| hive_partitioning | BOOLEAN | named |
| hive_types | ANY | named |
| hive_types_autocast | BOOLEAN | named |
| int96_as | VARCHAR | named |
| parquet_version | VARCHAR | named |
| path | VARIANT | positional (position 1) |
| prefetch_strategy | VARCHAR | named |
| schema | ANY | named |
| union_by_name | BOOLEAN | named |
| utf8_validation | VARCHAR | named |

Declared return type: unknown. Variadic argument type: none declared.
Stability: unknown. Declared side effects: unknown.

### overload-cc66f2e3c68b75a3

Kind: table. Parameter order: alphabetical-not-call-order.

```text
read_parquet(paths: ANY[], allow_empty := BOOLEAN, binary_as_string := BOOLEAN, bound_schema := ANY, can_have_nan := BOOLEAN, column_statistics := ANY, compression := VARCHAR, debug_use_openssl := BOOLEAN, encryption_config := ANY, explicit_cardinality := UBIGINT, file_row_number := BOOLEAN, filename := ANY, hive_partitioning := BOOLEAN, hive_types := ANY, hive_types_autocast := BOOLEAN, int96_as := VARCHAR, parquet_version := VARCHAR, prefetch_strategy := VARCHAR, schema := ANY, union_by_name := BOOLEAN, utf8_validation := VARCHAR) → TABLE
```

Link: /products/haybarn/functions/releases/duckdb-2.0.0/read_parquet/#overload-cc66f2e3c68b75a3

| Argument | Catalog type | Calling mode |
| --- | --- | --- |
| allow_empty | BOOLEAN | named |
| binary_as_string | BOOLEAN | named |
| bound_schema | ANY | named |
| can_have_nan | BOOLEAN | named |
| column_statistics | ANY | named |
| compression | VARCHAR | named |
| debug_use_openssl | BOOLEAN | named |
| encryption_config | ANY | named |
| explicit_cardinality | UBIGINT | named |
| file_row_number | BOOLEAN | named |
| filename | ANY | named |
| hive_partitioning | BOOLEAN | named |
| hive_types | ANY | named |
| hive_types_autocast | BOOLEAN | named |
| int96_as | VARCHAR | named |
| parquet_version | VARCHAR | named |
| paths | ANY[] | positional (position 1) |
| prefetch_strategy | VARCHAR | named |
| schema | ANY | named |
| union_by_name | BOOLEAN | named |
| utf8_validation | VARCHAR | named |

Declared return type: unknown. Variadic argument type: none declared.
Stability: unknown. Declared side effects: unknown.


## Guide recipes

No guide recipes.

## Engine catalog examples

Source examples may require additional data or extensions. Expressions are wrapped in SELECT; execution verification is not recorded.

No catalog examples.

## Runnable examples

Executed successfully in Haybarn WASM 2.0.0-rc12. Sample data and guide examples are separate from the original catalog.

```sql
COPY (SELECT 'apples' AS fruit, 12 AS quantity)
TO 'harvest.parquet' (FORMAT PARQUET);

SELECT * FROM read_parquet('harvest.parquet');
```

## Additional DuckDB documentation

- [Reading and Writing Parquet Files](https://duckdb.org/docs/current/data/parquet/overview)
- [Parquet Encryption](https://duckdb.org/docs/current/data/parquet/encryption#reading-encrypted-parquet-files)
- [Parquet Tips](https://duckdb.org/docs/current/data/parquet/tips#use-union_by_name-when-loading-files-with-different-schemas)

## Observed availability

| Snapshot | Observed | Overloads | JSON |
| --- | --- | --- | --- |
| haybarn-2.0.0-rc12 | present | 3 | [reference](/products/haybarn/functions/api/v1/haybarn-2.0.0-rc12/functions/read_parquet.json) |
| haybarn-2.0.0-rc11 | present | 3 | [reference](/products/haybarn/functions/api/v1/haybarn-2.0.0-rc11/functions/read_parquet.json) |
| haybarn-2.0.0-rc8 | present | 3 | [reference](/products/haybarn/functions/api/v1/haybarn-2.0.0-rc8/functions/read_parquet.json) |
| haybarn-1.5.5-rc3 | present | 2 | [reference](/products/haybarn/functions/api/v1/haybarn-1.5.5-rc3/functions/read_parquet.json) |
| haybarn-1.5.6-rc6 | present | 2 | [reference](/products/haybarn/functions/api/v1/haybarn-1.5.6-rc6/functions/read_parquet.json) |
| duckdb-2.0.0 | present | 3 | [reference](/products/haybarn/functions/api/v1/duckdb-2.0.0/functions/read_parquet.json) |
| duckdb-1.5.6 | present | 2 | [reference](/products/haybarn/functions/api/v1/duckdb-1.5.6/functions/read_parquet.json) |
| duckdb-1.5.5 | present | 2 | [reference](/products/haybarn/functions/api/v1/duckdb-1.5.5/functions/read_parquet.json) |
| duckdb-1.4.4 | present | 2 | [reference](/products/haybarn/functions/api/v1/duckdb-1.4.4/functions/read_parquet.json) |
| duckdb-1.3.2 | present | 2 | [reference](/products/haybarn/functions/api/v1/duckdb-1.3.2/functions/read_parquet.json) |

Engine catalog documentation is derived from MIT-licensed Haybarn and DuckDB. [Notices](/third-party-notices.txt).
