postgis.gdal_enabled_drivers
Prev  7.22. 大一统自定义变量 (GUCs)  Next

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';