postgis.gdal_enabled_drivers
Prev  7.22. Grandes Variáveis Unificadas Personalizadas do PostGIS (GUCs)  Next

Name

postgis.gdal_enabled_drivers — Uma opção de configuração para estabelecer os drivers GDAL ativados no ambiente POstGIS. Afeta a variável GDAL_SKIP do GDAL.

Descrição

Uma opção de configuração para estabelecer os drivers GDAL ativados no PostGIS. Afeta a variável de configuração GDAL_SKIP. Essa opção pode ser estabelecida no arquivo de configuração do PostgreSQL: postgresql.conf. Ela também pode ser estabelecida por conexão ou transação.

O valor inicial do postgis.gdal_enabled_drivers também pode ser estabelecido passando a variável de ambiente POSTGIS_GDAL_ENABLED_DRIVERS com a lista de drivers ativados para o processo de começar o PostgreSQL.

Dispositivos ativados específicos GDAL podem ser especificados pelos dispositivos de nome ou código curto. Dispositivos com nomes ou códigos curtos podem ser encontrados emGDAL Raster Formats. Vários dispositivos podem ser encontrados, colocando um espaço entre cada um deles.

[Note]

Existem três códigos especiais disponíveis para postgis.gdal_enabled_drivers. Os códigos são case-sensitive.

  • DISABLE_ALL desabilita todos os drivers GDAL. Se presente, DISABLE_ALL excede todos os outros valores em postgis.gdal_enabled_drivers.

  • ENABLE_ALL ativa todos os drivers GDAL.

  • VSICURL ativa o arquivo do sistema virtual /vsicurl/ do GDAL.

Quando postgis.gdal_enabled_drivers é configurado para DESABILITAR_TODOS, tenta usar out-db rasters, ST_FromGDALRaster(), ST_AsGDALRaster(), ST_AsTIFF(), ST_AsJPEG() e ST_AsPNG() resultará em mensagens de erro.

[Note]

Na instalação padrão do PostGIS, postgis.gdal_enabled_drivers é configurado para DESABILITAR_TODOS.

[Note]

Informações adicionais sobre GDAL_SKIP estão disponíveis em Opções de Configuração.

Disponibilidade: 2.2.0

Exemplos

Set and reset postgis.gdal_enabled_drivers for the current session.

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

Set specific drivers for all new connections to a database.

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

Set the default for the whole database cluster to enable all drivers. This requires superuser access. Also note that database, session, and user settings override this.

This example writes the setting to postgres.auto.conf.

ALTER SYSTEM SET postgis.gdal_enabled_drivers TO 'ENABLE_ALL';

Reload the PostgreSQL configuration so the changed setting is applied.

SELECT pg_reload_conf();