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

Name

postgis.gdal_enabled_drivers — Option de configuration permettant de définir les drivers GDAL activés dans l'environnement PostGIS. Affecte la variable de configuration GDAL GDAL_SKIP.

Description

Option de configuration permettant de définir les drivers GDAL activés dans l'environnement PostGIS. Affecte la variable de configuration GDAL GDAL_SKIP. Cette option peut être définie dans le fichier de configuration de PostgreSQL : postgresql.conf. Elle peut également être définie par connexion ou transaction.

La valeur initiale de postgis.gdal_enabled_drivers peut aussi être définie en passant la variable d'environnement POSTGIS_GDAL_ENABLED_DRIVERS avec la liste des drivers activés au processus de démarrage de PostgreSQL.

Les drivers GDAL activés peuvent être spécifiés par leur nom abrégé ou leur code. Les noms courts ou les codes des drivers sont disponibles sur GDAL Raster Formats. Il est possible de spécifier plusieurs drivers en insérant un espace entre chacun d'eux.

[Note]

Trois codes spéciaux sont disponibles pour postgis.gdal_enabled_drivers. Les codes sont sensibles à la casse.

  • DISABLE_ALL désactive tous les drivers GDAL. S'il est présent, DISABLE_ALL remplace toutes les autres valeurs de postgis.gdal_enabled_drivers.

  • ENABLE_ALL active tous les drivers GDAL.

  • VSICURL active le système de fichiers virtuels /vsicurl/ de GDAL.

Lorsque postgis.gdal_enabled_drivers est défini sur DISABLE_ALL, les tentatives d'utilisation des rasters out-db, ST_FromGDALRaster(), ST_AsGDALRaster(), ST_AsTIFF(), ST_AsJPEG() et ST_AsPNG() se traduisent par des messages d'erreur.

[Note]

Dans l'installation standard de PostGIS, postgis.gdal_enabled_drivers est défini sur DISABLE_ALL.

[Note]

Des informations supplémentaires sur GDAL_SKIP sont disponibles sur le site GDAL Configuration Options.

Disponibilité : 2.2.0

Exemples

To set and reset postgis.gdal_enabled_drivers for current session

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

Set for all new connections to a specific database to specific drivers

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

Setting for whole database cluster to enable all drivers. Requires super user access. Also note that database, session, and user settings override this.

--writes to postgres.auto.conf
ALTER SYSTEM SET postgis.gdal_enabled_drivers TO 'ENABLE_ALL';
 --Reloads postgres conf
SELECT pg_reload_conf();