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

postgis.gdal_enabled_drivers setzen und zurücksetzen

Bestimmt das Backend, das für alle neuen Verbindungen zur Datenbank verwendet wird

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

Setzt die standardmäßig aktivierten Treiber für alle neuen Verbindungen zum Server. Benötigt Administratorrechte und PostgreSQL 9.4+. Beachten Sie aber bitte, dass die Datenbank-, Sitzungs- und Benutzereinstellungen dies überschreiben.

ALTER SYSTEM SET postgis.gdal_enabled_drivers TO 'GTiff PNG JPEG';
SELECT pg_reload_conf();
                
SET postgis.gdal_enabled_drivers TO 'GTiff PNG JPEG';
SET postgis.gdal_enabled_drivers = default;

Aktiviert alle GDAL-Treiber

SET postgis.gdal_enabled_drivers = 'ENABLE_ALL';

Deaktiviert alle GDAL-Treiber

SET postgis.gdal_enabled_drivers = 'DISABLE_ALL';