gdal driver parquet create-metadata-file

Added in version 3.13.

Create the _metadata file for a partitioned Parquet dataset

Synopsis

Usage: gdal driver parquet create-metadata-file [OPTIONS] <INPUT>... <OUTPUT>

Create the _metadata file for a partitioned dataset

Positional arguments:
  --input <INPUT>         Input Parquet datasets (created by algorithm) [1.. values] [required]
  --output <OUTPUT>       Output Parquet dataset [required]

Common Options:
  -h, --help              Display help message and exit
  --json-usage            Display usage as JSON document and exit
  --config <KEY>=<VALUE>  Configuration option [may be repeated]

Options:
  --overwrite             Whether overwriting existing output is allowed

Description

Creates a _metadata Parquet metadata-only file that contains the schema of the partitioned Parquet files and the path to them.

This program is automatically called by gdal vector partition for a Parquet output.

Return status code

The program returns status code 0 in case of success, and non-zero in case of error (non-blocking errors emitted as warnings are considered as a successful execution).

Examples

Example 1

gdal driver parquet create-metadata-file --input partitioned/0.parquet \
            --input partitioned/1.parquet --output partitioned/_metadata