第 3 章。PostGIS 管理

這些設定是在 postgresql.conf 中設定的

constraint_exclusion

shared_buffers

max_worker_processes 此設定僅適用於 PostgreSQL 9.4+。對於 PostgreSQL 9.6+，此設定具有額外的重要性，因為它控制平行查詢可以擁有的最大處理程序數。

work_mem - 設定用於排序作業和複雜查詢的記憶體大小

maintenance_work_mem - 用於 VACUUM、CREATE INDEX 等的記憶體大小。

max_parallel_workers_per_gather

此設定僅適用於 PostgreSQL 9.6+，並且僅會影響 PostGIS 2.3+，因為只有 PostGIS 2.3+ 支援平行查詢。如果設定為高於 0，則某些查詢（例如涉及關係函數（如 ST_Intersects）的查詢）可以使用多個處理程序，並且在這樣做時可以快兩倍以上。如果您有多餘的處理器可用，則應將此值變更為您擁有的處理器數。此外，請確保將 max_worker_processes 提升到至少與此數字一樣高。

如果您使用的是 PostgreSQL 9.1+，並且已編譯並安裝 extensions/postgis 模組，則可以使用 EXTENSION 機制將資料庫變成空間資料庫。

核心 postgis 擴充功能包括幾何圖形、地理、spatial_ref_sys 以及所有函數和註解。Raster 和拓撲會作為單獨的擴充功能打包。

在您要啟用空間功能的資料庫中執行下列 SQL 片段

      CREATE EXTENSION IF NOT EXISTS plpgsql;
      CREATE EXTENSION postgis;
      CREATE EXTENSION postgis_raster; -- OPTIONAL
      CREATE EXTENSION postgis_topology; -- OPTIONAL

	如果您無法或不想在 PostgreSQL 擴充功能目錄中安裝 PostGIS (例如在測試、開發或受限環境中)，則通常只需要這樣做。

將 PostGIS 物件和函數定義新增至您的資料庫的方法是載入在建置階段指定的 [prefix]/share/contrib 中找到的各種 sql 檔案。

核心 PostGIS 物件 (幾何圖形和地理類型，以及其支援函數) 位於 postgis.sql 指令檔中。Raster 物件位於 rtpostgis.sql 指令檔中。拓撲物件位於 topology.sql 指令檔中。

若要取得一組完整的 EPSG 坐標系統定義識別碼，您也可以載入 spatial_ref_sys.sql 定義檔案，並填入 spatial_ref_sys 資料表。這將允許您對幾何圖形執行 ST_Transform() 作業。

如果您想要將註解新增至 PostGIS 函數，您可以在 postgis_comments.sql 指令檔中找到它們。只要從 psql 終端機視窗輸入 \dd [function_name] 即可檢視註解。

在您的終端機中執行下列 Shell 命令

    DB=[yourdatabase]
    SCRIPTSDIR=`pg_config --sharedir`/contrib/postgis-3.4/

    # Core objects
    psql -d ${DB} -f ${SCRIPTSDIR}/postgis.sql
    psql -d ${DB} -f ${SCRIPTSDIR}/spatial_ref_sys.sql
    psql -d ${DB} -f ${SCRIPTSDIR}/postgis_comments.sql # OPTIONAL

    # Raster support (OPTIONAL)
    psql -d ${DB} -f ${SCRIPTSDIR}/rtpostgis.sql
    psql -d ${DB} -f ${SCRIPTSDIR}/raster_comments.sql # OPTIONAL

    # Topology support (OPTIONAL)
    psql -d ${DB} -f ${SCRIPTSDIR}/topology.sql
    psql -d ${DB} -f ${SCRIPTSDIR}/topology_comments.sql # OPTIONAL

如果您使用擴充功能安裝資料庫，則也需要使用擴充功能模型進行升級。如果您使用舊的 sql 指令檔方式安裝，則建議您將安裝切換為擴充功能，因為不再支援指令檔方式。

3.4.1.1. 使用擴充功能的 9.1+ 軟升級

如果您最初使用擴充功能安裝 PostGIS，則也需要使用擴充功能進行升級。使用擴充功能進行次要升級相當簡單。

如果您執行的是 PostGIS 3 或更高版本，則應使用 PostGIS_Extensions_Upgrade 函數升級到您已安裝的最新版本。

SELECT postgis_extensions_upgrade();

如果您執行的是 PostGIS 2.5 或更低版本，請執行以下操作

ALTER EXTENSION postgis UPDATE;
SELECT postgis_extensions_upgrade();
-- This second call is needed to rebundle postgis_raster extension
SELECT postgis_extensions_upgrade();

如果您安裝了多個版本的 PostGIS，並且不想升級到最新版本，則可以按如下所示明確指定版本

ALTER EXTENSION postgis UPDATE TO "3.5.2dev";
ALTER EXTENSION postgis_topology UPDATE TO "3.5.2dev";

如果您收到類似以下的錯誤通知

No migration path defined for … to 3.5.2dev

那麼您需要備份資料庫，建立一個新的資料庫，如第 3.3.1 節，「使用 EXTENSION 以啟用資料庫的空間功能」中所述，然後在這個新資料庫上還原備份。

如果您收到類似以下的通知訊息

Version "3.5.2dev" of extension "postgis" is already installed

那麼一切都已經是最新的，您可以安全地忽略它。除非您嘗試從開發版本升級到下一個版本 (不會獲得新的版本號碼)；在這種情況下，您可以在版本字串中附加「next」，並且下次您需要再次刪除「next」後綴

ALTER EXTENSION postgis UPDATE TO "3.5.2devnext";
ALTER EXTENSION postgis_topology UPDATE TO "3.5.2devnext";

	如果您最初安裝 PostGIS 時沒有指定版本，則通常可以跳過還原之前重新安裝 postgis 擴充功能，因為備份只有 CREATE EXTENSION postgis，因此會在還原期間提取最新的最新版本。

	如果您要從 3.0.0 之前的版本升級 PostGIS 擴充功能，您將擁有一個新的擴充功能 postgis_raster，如果您不需要 raster 支援，您可以安全地刪除它。您可以按如下所示刪除 DROP EXTENSION postgis_raster;

3.4.1.2. 9.1+ 之前或沒有擴充功能的軟升級

本節僅適用於未使用擴充功能安裝 PostGIS 的使用者。如果您有擴充功能並嘗試使用此方法升級，您將收到類似以下的訊息

can't drop … because postgis extension depends on it

注意：如果您要從 PostGIS 1.* 移至 PostGIS 2.* 或從 r7409 之前的 PostGIS 2.* 移至 PostGIS 2.*，則您無法使用此程序，而是需要執行硬升級。

編譯並安裝 (make install) 後，您應該會在安裝資料夾中找到一組 *_upgrade.sql 檔案。您可以使用下列命令列出所有檔案

ls `pg_config --sharedir`/contrib/postgis-3.5.2dev/*_upgrade.sql

從 postgis_upgrade.sql 開始，依序載入所有檔案。

psql -f postgis_upgrade.sql -d your_spatial_database

相同的程序適用於 raster、拓撲和 sfcgal 擴充功能，其升級檔案分別命名為 rtpostgis_upgrade.sql、topology_upgrade.sql 和 sfcgal_upgrade.sql。如果您需要它們

psql -f rtpostgis_upgrade.sql -d your_spatial_database

psql -f topology_upgrade.sql -d your_spatial_database

psql -f sfcgal_upgrade.sql -d your_spatial_database

建議您透過執行下列命令來切換為以擴充功能為基礎的安裝

psql -c "SELECT postgis_extensions_upgrade();"

	如果您找不到專門用於升級您的版本的 postgis_upgrade.sql，表示您使用的版本過於老舊，無法進行軟升級，需要執行硬升級。

PostGIS_Full_Version 函數應該會透過「procs need upgrade」訊息告知您是否需要執行此類升級。

硬升級指的是完整傾印/重新載入已啟用 PostGIS 的資料庫。當 PostGIS 物件的內部儲存方式變更或無法進行軟升級時，您需要執行硬升級。版本說明附錄會針對每個版本報告是否需要透過傾印/重新載入 (硬升級) 來進行升級。

傾印/重新載入過程由 postgis_restore 腳本協助，該腳本會處理跳過傾印中屬於 PostGIS 的所有定義（包括舊定義），讓您可以將您的結構描述和資料還原到已安裝 PostGIS 的資料庫中，而不會出現重複符號錯誤或帶入已棄用的物件。

Windows 使用者的補充說明請參閱 Windows 硬升級。

步驟如下：

在以下情況下可能會發生錯誤：