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

示例

To set and reset postgis.gdal_enabled_drivers for current session

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

Set for all new connections to a specific database to specific drivers

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

Setting for whole database cluster to enable all drivers. Requires super user access. Also note that database, session, and user settings override this.

--writes to postgres.auto.conf
ALTER SYSTEM SET postgis.gdal_enabled_drivers TO 'ENABLE_ALL';
 --Reloads postgres conf
SELECT pg_reload_conf();