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

Définir et réinitialiser postgis.gdal_enabled_drivers

Définit le backend pour toutes les nouvelles connexions à la base de données

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

Définit les drivers activés par défaut pour toutes les nouvelles connexions au serveur. Nécessite un accès super utilisateur et PostgreSQL 9.4+. Notez également que les paramètres de la base de données, de la session et de l'utilisateur sont prioritaires.

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;
                

Activer tous les drivers GDAL

SET postgis.gdal_enabled_drivers = 'ENABLE_ALL';
                

Désactiver tous les drivers GDAL

SET postgis.gdal_enabled_drivers = 'DISABLE_ALL';
                

Voir aussi

ST_FromGDALRaster, ST_AsGDALRaster, ST_AsTIFF, ST_AsPNG, ST_AsJPEG, postgis.enable_outdb_rasters