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

Pour définir et réinitialiser postgis.gdal_enabled_drivers pour la session en cours

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

Définir pour toutes les nouvelles connexions à une base de données spécifique des pilotes spécifiques

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

Paramètre pour l'ensemble du cluster de bases de données afin d'activer tous les pilotes. Nécessite l'accès d'un super utilisateur. Notez également que les paramètres de la base de données, de la session et de l'utilisateur sont prioritaires.

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