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();