postgis.gdal_enabled_drivers
Föregående  7.22. Grand Unified Custom Variables (GUC)  Nästa

Namn

postgis.gdal_enabled_drivers — Ett konfigurationsalternativ för att ställa in de aktiverade GDAL-drivrutinerna i PostGIS-miljön. Påverkar GDAL-konfigurationsvariabeln GDAL_SKIP.

Beskrivning

Ett konfigurationsalternativ för att ställa in de aktiverade GDAL-drivrutinerna i PostGIS-miljön. Påverkar GDAL-konfigurationsvariabeln GDAL_SKIP. Det här alternativet kan ställas in i PostgreSQL: s konfigurationsfil: postgresql.conf. Det kan också ställas in via anslutning eller transaktion.

Det initiala värdet för postgis.gdal_enabled_drivers kan också ställas in genom att skicka miljövariabeln POSTGIS_GDAL_ENABLED_DRIVERS med listan över aktiverade drivrutiner till processen som startar PostgreSQL.

Aktiverade GDAL specificerade drivrutiner kan specificeras med drivrutinens kortnamn eller kod. Kortnamn eller koder för drivrutiner finns på GDAL Raster Formats. Flera drivrutiner kan specificeras genom att lägga till ett mellanslag mellan varje drivrutin.

[Notera]

Det finns tre specialkoder tillgängliga för postgis.gdal_enabled_drivers. Koderna är skiftlägeskänsliga.

  • DISABLE_ALL inaktiverar alla GDAL-drivrutiner. Om DISABLE_ALL finns där åsidosätter den alla andra värden i postgis.gdal_enabled_drivers.

  • ENABLE_ALL aktiverar alla GDAL-drivrutiner.

  • VSICURL aktiverar GDAL:s virtuella filsystem /vsicurl/.

När postgis.gdal_enabled_drivers är satt till DISABLE_ALL kommer försök att använda out-db rasters, ST_FromGDALRaster(), ST_AsGDALRaster(), ST_AsTIFF(), ST_AsJPEG() och ST_AsPNG() att resultera i felmeddelanden.

[Notera]

I standardinstallationen av PostGIS är postgis.gdal_enabled_drivers inställd på DISABLE_ALL.

[Notera]

Ytterligare information om GDAL_SKIP finns på GDAL:s konfigurationsalternativ.

Tillgänglighet: 2.2.0

Exempel

Ange och återställ postgis.gdal_enabled_drivers för den aktuella sessionen.

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

Ange specifika drivrutiner för alla nya anslutningar till en databas.

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

Ange standardvärdet för hela databasklustret så att alla drivrutiner aktiveras. Detta kräver superanvändaråtkomst. Observera också att inställningar för databas, session och användare åsidosätter detta.

Det här exemplet skriver inställningen till postgres.auto.conf.

Kod
ALTER SYSTEM SET postgis.gdal_enabled_drivers TO 'ENABLE_ALL';

Läs in PostgreSQL-konfigurationen på nytt så att den ändrade inställningen tillämpas.

Kod
SELECT pg_reload_conf();