postgis.gdal_enabled_drivers
Prev  7.22. PostGIS Grand Unified Custom Variables (GUCs)  Next

Name

postgis.gdal_enabled_drivers — Eine Konfigurationsmöglichkeit um einen GDAL Treiber in der PostGIS Umgebung zu aktivieren. Beeinflusst die Konfigurationsvariable GDAL_SKIP von GDAL.

Beschreibung

Eine Konfigurationsmöglichkeit um einen GDAL Treiber in der PostGIS Umgebung zu aktivieren. Beeinflusst die Konfigurationsvariable GDAL_SKIP von GDAL. Diese Option kann in der PostgreSQL Konfigurationsdatei "postgresql.conf" gesetzt werden. Sie kann aber auch pro Verbindung oder pro Transaktion gesetzt werden. 

Der Ausgangswert von postgis.gdal_enabled_drivers kann auch beim Startprozess von PostgreSQL gesetzt werden, nämlich durch die Übergabe der Umgebungsvariablen POSTGIS_GDAL_ENABLED_DRIVERS, welche die Liste der aktivierten Treiber enthält.

Aktivierte GDAL Treiber können auch über die Kurzbezeichnung oder den Code des Treibers bestimmt werden. Kurzbezeichnungen und Codes für die Treiber finden sich unter GDAL Raster Formate Es können mehrere, durch Leerzeichen getrennte Treiber angegeben werden.

[Note]

Für postgis.gdal_enabled_drivers sind drei spezielle, case-sensitive Codes verfügbar.

  • DISABLE_ALL deaktiviert alle GDAL-Treiber. Falls vorhanden, überschreibt DISABLE_ALL alle anderen Werte in postgis.gdal_enabled_drivers.

  • ENABLE_ALL aktiviert alle GDAL-Treiber.

  • VSICURL aktiviert GDAL's /vsicurl/ virtuelles Dateisystem.

Falls postgis.gdal_enabled_driversauf DISABLE_ALL gesetzt ist, kommt es bei der Anwendung von out-db Rastern, ST_FromGDALRaster(), ST_AsGDALRaster(), ST_AsTIFF(), ST_AsJPEG() und ST_AsPNG() zu Fehlermeldungen.

[Note]

postgis.gdal_enabled_drivers wird bei der Standardinstallation von PostGIS auf DISABLE_ALL gesetzt.

[Note]

Weiterführende Informationen über GDAL_SKIP ist auf GDAL's Configuration Options zu finden.

Verfügbarkeit: 2.2.0

Beispiele

Set and reset postgis.gdal_enabled_drivers for the current session.

SET postgis.gdal_enabled_drivers = 'ENABLE_ALL';
SET postgis.gdal_enabled_drivers = default;

Set specific drivers for all new connections to a database.

ALTER DATABASE mygisdb SET postgis.gdal_enabled_drivers TO 'GTiff PNG JPEG';

Set the default for the whole database cluster to enable all drivers. This requires superuser access. Also note that database, session, and user settings override this.

This example writes the setting to postgres.auto.conf.

ALTER SYSTEM SET postgis.gdal_enabled_drivers TO 'ENABLE_ALL';

Reload the PostgreSQL configuration so the changed setting is applied.

SELECT pg_reload_conf();