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

示例

Set and reset postgis.gdal_enabled_drivers for the current session.

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

Set specific drivers for all new connections to a database.

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

Set the default for the whole database cluster to enable all drivers. This requires superuser access. Also note that database, session, and user settings override this.

This example writes the setting to postgres.auto.conf.

ALTER SYSTEM SET postgis.gdal_enabled_drivers TO 'ENABLE_ALL';

Reload the PostgreSQL configuration so the changed setting is applied.

SELECT pg_reload_conf();