NAME

gdal-vector-export-schema - Export the OGR_SCHEMA from a vector dataset

Added in version 3.13.

SYNOPSIS

Usage: gdal vector export-schema [OPTIONS] <INPUT>...
Export the OGR_SCHEMA from a vector dataset.
Positional arguments:
  -i, --dataset, --input <INPUT>            Input vector datasets [may be repeated] [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:
  -l, --layer, --input-layer <INPUT-LAYER>  Input layer name [may be repeated]
Advanced Options:
  --oo, --open-option <KEY>=<VALUE>         Open options [may be repeated]
  --if, --input-format <INPUT-FORMAT>       Input formats [may be repeated]

DESCRIPTION

gdal vector export-schema exports the OGR_SCHEMA from a GDAL supported vector dataset, and returns it on the standard output stream when used from the command line, or in the output parameter when used from the API.

OGR_SCHEMA is a JSON object describing the structure of a vector dataset according to the schema definition at ogr_fields_override.schema.json

gdal vector export-schema can be used as the last step of a pipeline.

The following options are available:

PROGRAM-SPECIFIC OPTIONS

-l, --layer, --input-layer <INPUT-LAYER>: Name of one or more layers to inspect. If no layer names are passed, then all layers will be selected.

. Standard Options ----------------

--oo, --open-option <NAME>=<VALUE>: Dataset open option (format specific).
May be repeated.

--if, --input-format <format>: Format/driver name to be attempted to open the input file(s). It is generally not necessary to specify it, but it can be used to skip automatic driver detection, when it fails to select the appropriate driver. This option can be repeated several times to specify several candidate drivers. Note that it does not force those drivers to open the dataset. In particular, some drivers have requirements on file extensions.
May be repeated.

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: Extracting the OGR_SCHEMA from the file poly.gpkg

gdal vector export-schema poly.gpkg

AUTHOR

Alessandro Pasotti <elpaso@itopen.it>

COPYRIGHT

1998-2026

May 8, 2026