名称

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_FromGDALRasterST_AsGDALRasterST_AsTIFFST_AsPNGST_AsJPEGpostgis.enable_outdb_rasters