Name

postgis.gdal_enabled_drivers — 在PostGIS环境中设置启用的GDAL驱动程序的配置选项。影响GDAL配置变量GDAL_SKIP。

描述

在PostGIS环境中设置启用的GDAL驱动程序的配置选项。影响GDAL配置变量GDAL_SKIP。该选项可以在PostgreSQL的配置文件中设置:postgresql.conf。也可以通过连接或事务进行设置。

的初始值 postgis.gdal_enabled_drivers 也可以通过传递环境变量 POSTGIS_GDAL_ENABLED_DRIVERS 启动PostgreSQL进程的已启用驱动程序列表。

启用GDAL指定的驱动程序可以通过驱动程序的短名称或代码指定。司机简称或代码可在以下位置找到 GDAL栅格格式 。可以通过在每个驱动程序之间放置空格来指定多个驱动程序。

[Note]

有三种特殊代码可用于 postgis.gdal_enabled_drivers 。代码区分大小写。

  • DISABLE_ALL 禁用所有GDAL驱动程序。如果存在, DISABLE_ALL 中的所有其他值 postgis.gdal_enabled_drivers

  • ENABLE_ALL 启用所有GDAL驱动程序。

  • VSICURL 启用GDAL /vsicurl/ 虚拟文件系统。

什么时候 postgis.gdal_enabled_drivers 设置为DISABLE_ALL,则尝试使用Out-db栅格、ST_FromGDALRaster()、ST_AsGDALRaster()、ST_AsTIFF()、ST_AsJPEG()和ST_AsPNG()将导致错误消息。

[Note]

在标准的PostGIS安装中, postgis.gdal_enabled_drivers 设置为DISABLE_ALL。

[Note]

有关GDAL_SKIP的更多信息,请访问GDAL的 配置选项

可用性:2.2.0

示例

设置和重置 postgis.gdal_enabled_drivers

为到数据库的所有新连接设置后端

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

为所有到服务器的新连接设置默认启用的驱动程序。需要超级用户访问权限和PostgreSQL 9.4+。另请注意,数据库、会话和用户设置会覆盖此设置。

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;
                

启用所有GDAL驱动程序

SET postgis.gdal_enabled_drivers = 'ENABLE_ALL';
                

禁用所有GDAL驱动程序

SET postgis.gdal_enabled_drivers = 'DISABLE_ALL';
                

另请参阅

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