postgis.gdal_enabled_drivers
上一页  7.22. 统一自定义变量（GUCs）  下一页

名称

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 时，尝试使用数据库外栅格、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

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

为连接到特定数据库的所有新连接设置特定驱动程序

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

为整个数据库集群设置以启用所有驱动程序。需要超级用户访问权限。另请注意，数据库、会话和用户设置会覆盖此设置。

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