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

Configurar e resetar postgis.gdal_enabled_drivers

Configura backend para todas as novas conexões para o banco de dados

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

Estabelece drivers ativados padrões para todas as conexões para fazer a manutenção. Requer acesso super do usuário e PostgreSQL 9.4+. Aquele banco de dados, sessão e usuário não excedem isso.

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;

Ativar todos os dispositivos GDAL

SET postgis.gdal_enabled_drivers = 'ENABLE_ALL';

Desativar todos os dispositivos GDAL

SET postgis.gdal_enabled_drivers = 'DISABLE_ALL';