第 2 章  PostGIS 安裝

從下載網站擷取 PostGIS 原始碼封存 https://postgis.dev.org.tw/stuff/postgis-3.5.2dev.tar.gz

wget https://postgis.dev.org.tw/stuff/postgis-3.5.2dev.tar.gz
tar -xvzf postgis-3.5.2dev.tar.gz
cd postgis-3.5.2dev

這會在目前的工作目錄中建立一個名為 postgis-3.5.2dev 的目錄。

或者，從 git 儲存庫 https://git.osgeo.org/gitea/postgis/postgis/ 中取出原始碼。

git clone https://git.osgeo.org/gitea/postgis/postgis.git postgis
cd postgis
sh autogen.sh
    

變更至新建立的 postgis 目錄以繼續安裝。

./configure

PostGIS 有以下建置和使用需求

必要項目

選用項目

與大多數 Linux 安裝一樣，第一步是產生將用於建置原始碼的 Makefile。這透過執行 Shell 指令碼來完成

./configure

在沒有其他參數的情況下，此命令將嘗試自動定位建置系統上 PostGIS 原始碼所需的元件和程式庫。雖然這是 ./configure 最常見的用法，但指令碼接受一些參數，以供在非標準位置擁有所需程式庫和程式的使用者使用。

以下清單僅顯示最常用的參數。如需完整清單，請使用 --help 或 --help=short 參數。

	如果您從 程式碼儲存庫 取得 PostGIS，第一步實際上是執行腳本 ./autogen.sh 此腳本將產生 configure 腳本，該腳本接著用於自訂 PostGIS 的安裝。 如果您改為將 PostGIS 作為 tarball 取得，則不需要執行 ./autogen.sh，因為 configure 已產生。

產生 Makefile 後，建置 PostGIS 就如同執行

make

輸出的最後一行應為 "PostGIS was built successfully. Ready to install."

自 PostGIS v1.4.0 起，所有函式都有從文件產生的註解。如果您稍後想要將這些註解安裝到您的空間資料庫中，請執行需要 docbook 的命令。postgis_comments.sql 和其他套件註解檔案 raster_comments.sql、topology_comments.sql 也打包在 tar.gz 發行版的 doc 資料夾中，因此如果從 tar ball 安裝，則不需要製作註解。註解也包含在 CREATE EXTENSION 安裝中。

make comments

在 PostGIS 2.0 中引入。這會產生適合快速參考或學生講義的 html 速查表。這需要 xsltproc 來建置，並將在 doc 資料夾中產生 4 個檔案 topology_cheatsheet.html、tiger_geocoder_cheatsheet.html、raster_cheatsheet.html、postgis_cheatsheet.html

您可以從 PostGIS / PostgreSQL 學習指南 下載一些以 html 和 pdf 提供的預先建置的速查表。

make cheatsheets

如果您使用 PostgreSQL 9.1+，PostGIS 擴充功能會自動建置和安裝。

如果您是從原始碼儲存庫建置，您需要先建置函式描述。如果您已安裝 docbook，則會建置這些描述。您也可以使用下列語句手動建置

make comments

如果您是從發行 tar ball 建置，則不需要建置註解，因為這些註解已與 tar ball 一起預先建置打包。

這些擴充功能應作為 make install 程序的一部分自動建置。如果需要，您可以從擴充功能資料夾建置，或者如果您需要在不同的伺服器上使用它們，則可以複製檔案。

cd extensions
cd postgis
make clean
make
export PGUSER=postgres #overwrite psql variables
make check #to test before install
make install
# to test extensions
make check RUNTESTFLAGS=--extension

	make check 使用 psql 來執行測試，因此可以使用 psql 環境變數。常用且有用的覆寫變數是 PGUSER、PGPORT 和 PGHOST。請參閱 psql 環境變數

對於相同版本的 PostGIS 和 PostgreSQL，無論作業系統為何，擴充功能檔案都將始終相同，因此只要您的伺服器上已安裝 PostGIS 二進位檔，就可以將擴充功能檔案從一個作業系統複製到另一個作業系統。

如果您想要在與開發伺服器不同的單獨伺服器上手動安裝擴充功能，您需要將下列檔案從擴充功能資料夾複製到 PostgreSQL 安裝的 PostgreSQL / share / extension 資料夾中，以及如果您的伺服器上尚未安裝常規 PostGIS 所需的二進位檔。

執行此操作後，您應該會在 PgAdmin -> 擴充功能中看到 postgis、postgis_topology 作為可用的擴充功能。

如果您使用 psql，您可以使用此查詢驗證擴充功能是否已安裝

SELECT name, default_version,installed_version
FROM pg_available_extensions WHERE name LIKE 'postgis%' or name LIKE 'address%';

             name             | default_version | installed_version
------------------------------+-----------------+-------------------
 address_standardizer         | 3.5.2dev         | 3.5.2dev
 address_standardizer_data_us | 3.5.2dev         | 3.5.2dev
 postgis                      | 3.5.2dev         | 3.5.2dev
 postgis_raster               | 3.5.2dev         | 3.5.2dev
 postgis_sfcgal               | 3.5.2dev         |
 postgis_tiger_geocoder       | 3.5.2dev         | 3.5.2dev
 postgis_topology             | 3.5.2dev         |
(6 rows)

如果您在您查詢的資料庫中安裝了擴充功能，您將會在 installed_version 欄中看到提及。如果沒有傳回任何記錄，則表示您的伺服器上根本沒有安裝 postgis 擴充功能。PgAdmin III 1.14+ 也會在資料庫瀏覽器樹狀結構的 extensions 區段中提供此資訊，甚至允許透過按一下滑鼠右鍵來升級或解除安裝。

如果您有可用的擴充功能，您可以使用 pgAdmin 擴充功能介面或執行以下 sql 命令，在您選擇的資料庫中安裝 postgis 擴充功能

CREATE EXTENSION postgis;
CREATE EXTENSION postgis_raster;
CREATE EXTENSION postgis_sfcgal;
CREATE EXTENSION fuzzystrmatch; --needed for postgis_tiger_geocoder
--optional used by postgis_tiger_geocoder, or can be used standalone
CREATE EXTENSION address_standardizer;
CREATE EXTENSION address_standardizer_data_us;
CREATE EXTENSION postgis_tiger_geocoder;
CREATE EXTENSION postgis_topology;

在 psql 中，您可以使用它來查看您已安裝的版本以及它們所安裝的綱要。

\connect mygisdb
\x
\dx postgis*

List of installed extensions
-[ RECORD 1 ]-------------------------------------------------
Name        | postgis
Version     | 3.5.2dev
Schema      | public
Description | PostGIS geometry, geography, and raster spat..
-[ RECORD 2 ]-------------------------------------------------
Name        | postgis_raster
Version     | 3.0.0dev
Schema      | public
Description | PostGIS raster types and functions
-[ RECORD 3 ]-------------------------------------------------
Name        | postgis_tiger_geocoder
Version     | 3.5.2dev
Schema      | tiger
Description | PostGIS tiger geocoder and reverse geocoder
-[ RECORD 4 ]-------------------------------------------------
Name        | postgis_topology
Version     | 3.5.2dev
Schema      | topology
Description | PostGIS topology spatial types and functions

	擴充功能資料表 spatial_ref_sys、layer、topology 無法明確備份。只有在備份各自的 postgis 或 postgis_topology 擴充功能時，才能備份它們，這似乎只有在備份整個資料庫時才會發生。自 PostGIS 2.0.1 起，只有未與 PostGIS 一起打包的 srid 記錄會在備份資料庫時備份，因此請勿更改我們打包的 srid，並期望您的變更會在那裡。如果您發現問題，請提出票證。擴充功能資料表的結構永遠不會備份，因為它們是使用 CREATE EXTENSION 建立的，並且假設對於給定版本的擴充功能來說是相同的。這些行為已建置到目前的 PostgreSQL 擴充功能模型中，因此我們無法對此做任何事情。

如果您安裝了 3.5.2dev，但未使用我們出色的擴充功能系統，您可以透過執行以下命令將其變更為基於擴充功能的系統，以將函式打包到它們各自的擴充功能中。PostgreSQL 13 中移除了使用 `unpackaged` 安裝的方式，因此建議您在升級到 PostgreSQL 13 之前切換到擴充功能建置。

CREATE EXTENSION postgis FROM unpackaged;
CREATE EXTENSION postgis_raster FROM unpackaged;
CREATE EXTENSION postgis_topology FROM unpackaged;
CREATE EXTENSION postgis_tiger_geocoder FROM unpackaged;

如果您想要測試 PostGIS 建置，請執行

make check

上述命令將使用產生的函式庫對實際的 PostgreSQL 資料庫執行各種檢查和迴歸測試。

	如果您使用非標準的 PostgreSQL、GEOS 或 Proj 位置設定 PostGIS，您可能需要將其函式庫位置新增至 LD_LIBRARY_PATH 環境變數。

	目前，make check 在執行檢查時依賴 PATH 和 PGPORT 環境變數，它不使用可能已使用設定參數 --with-pgconfig 指定的 PostgreSQL 版本。因此，請務必修改您的 PATH 以符合組態期間偵測到的 PostgreSQL 安裝，或準備好處理即將發生的頭痛問題。

如果成功，make check 將產生將近 500 個測試的輸出。結果將如下所示 (下面省略了許多行)

     CUnit - A unit testing framework for C - Version 2.1-3
     http://cunit.sourceforge.net/

	.
	.
	.

Run Summary:    Type  Total    Ran Passed Failed Inactive
              suites     44     44    n/a      0        0
               tests    300    300    300      0        0
             asserts   4215   4215   4215      0      n/a
Elapsed time =    0.229 seconds

	.
	.
	.

Running tests

	.
	.
	.

Run tests: 134
Failed: 0


-- if you build with SFCGAL

	.
	.
	.

Running tests

	.
	.
	.

Run tests: 13
Failed: 0

-- if you built with raster support

	.
	.
	.

Run Summary:    Type  Total    Ran Passed Failed Inactive
              suites     12     12    n/a      0        0
               tests     65     65     65      0        0
             asserts  45896  45896  45896      0      n/a


	.
	.
	.

Running tests

	.
	.
	.

Run tests: 101
Failed: 0

-- topology regress

.
.
.

Running tests

	.
	.
	.

Run tests: 51
Failed: 0

-- if you built --with-gui, you should see this too

     CUnit - A unit testing framework for C - Version 2.1-2
     http://cunit.sourceforge.net/

	.
	.
	.

Run Summary:    Type  Total    Ran Passed Failed Inactive
              suites      2      2    n/a      0        0
               tests      4      4      4      0        0
             asserts      4      4      4      0      n/a

postgis_tiger_geocoder 和 address_standardizer 擴充功能目前僅支援標準的 PostgreSQL installcheck。若要測試這些，請使用以下命令。注意：如果您已在 PostGIS 程式碼資料夾的根目錄執行 make install，則不需要執行 make install。

對於 address_standardizer

cd extensions/address_standardizer
make install
make installcheck
	  

輸出應如下所示

============== dropping database "contrib_regression" ==============
DROP DATABASE
============== creating database "contrib_regression" ==============
CREATE DATABASE
ALTER DATABASE
============== running regression test queries        ==============
test test-init-extensions     ... ok
test test-parseaddress        ... ok
test test-standardize_address_1 ... ok
test test-standardize_address_2 ... ok

=====================
 All 4 tests passed.
=====================

對於 tiger 地理編碼器，請確保您的 PostgreSQL 執行個體中有 postgis 和 fuzzystrmatch 擴充功能可用。如果您使用 address_standardizer 支援建置 postgis，則 address_standardizer 測試也會啟動

cd extensions/postgis_tiger_geocoder
make install
make installcheck
	  

輸出應如下所示

============== dropping database "contrib_regression" ==============
DROP DATABASE
============== creating database "contrib_regression" ==============
CREATE DATABASE
ALTER DATABASE
============== installing fuzzystrmatch               ==============
CREATE EXTENSION
============== installing postgis                     ==============
CREATE EXTENSION
============== installing postgis_tiger_geocoder      ==============
CREATE EXTENSION
============== installing address_standardizer        ==============
CREATE EXTENSION
============== running regression test queries        ==============
test test-normalize_address   ... ok
test test-pagc_normalize_address ... ok

=====================
All 2 tests passed.
=====================

若要安裝 PostGIS，請輸入

make install

這會將 PostGIS 安裝檔案複製到 --prefix 設定參數指定的適當子目錄中。特別是

如果您先前執行了 make comments 命令來產生 postgis_comments.sql、raster_comments.sql 檔案，請透過執行以下命令來安裝 sql 檔案

make comments-install

	postgis_comments.sql、raster_comments.sql、topology_comments.sql 已與典型的建置和安裝目標分開，因為它附帶了 xsltproc 的額外相依性。

人們的許多抱怨之一是地址標準化函式 Normalize_Address，該函式會標準化地址以進行地理編碼前的準備。標準化工具遠非完美，並且嘗試修補其不完善之處需要大量的資源。因此，我們已與另一個專案整合，該專案具有更好的地址標準化引擎。若要使用這個新的 address_standardizer，您可以如第 2.3 節，「安裝和使用地址標準化工具」中所述編譯擴充功能，並將其作為擴充功能安裝在您的資料庫中。

在您將此擴充功能安裝在與您已安裝 postgis_tiger_geocoder 的同一個資料庫中之後，就可以使用 Pagc_Normalize_Address 來代替 Normalize_Address。此擴充功能與 tiger 無關，因此可以與其他資料來源（例如國際地址）一起使用。tiger 地理編碼器擴充功能確實附帶了自己的自訂版本規則表格（tiger.pagc_rules）、gaz 表格（tiger.pagc_gaz）和lex 表格（tiger.pagc_lex）。您可以新增和更新這些內容，以改善您自己需求的標準化體驗。

載入程序會從人口普查網站下載各個國家檔案、請求的州、解壓縮這些檔案，然後將每個州載入到其各自的一組州表格中。每個州表格都會繼承自 tiger 綱要中定義的表格，因此只需查詢這些表格即可存取所有資料，並在任何時候使用 Drop_State_Tables_Generate_Script 刪除一組州表格，如果您需要重新載入某個州或只是不再需要某個州。

若要能夠載入資料，您需要以下工具

如果您要從 tiger_2010 升級，您需要先產生並執行 Drop_Nation_Tables_Generate_Script。在您載入任何州資料之前，您需要載入全國資料，這可以使用 Loader_Generate_Nation_Script 來執行。這將為您產生一個載入器指令碼。Loader_Generate_Nation_Script 是一個一次性的步驟，應該在升級（從前一年的 tiger 人口普查資料）和新安裝時執行。

若要載入州資料，請參閱 Loader_Generate_Script，以針對您想要的州為您的平台產生資料載入指令碼。請注意，您可以逐步安裝這些資料。您不必一次載入所有想要的州。您可以根據需要載入它們。

在載入您想要的州之後，請務必執行

SELECT install_missing_indexes();

如 Install_Missing_Indexes 中所述。

若要測試事情是否按應有的方式運作，請嘗試使用 Geocode 在您州中的地址上執行地理編碼

首先，按照以下步驟升級您的 postgis_tiger_geocoder 擴充功能

ALTER EXTENSION postgis_tiger_geocoder UPDATE;

接著，刪除所有全國表格並載入新的表格。使用此 SQL 陳述式產生刪除指令碼，如 Drop_Nation_Tables_Generate_Script 中詳述

SELECT drop_nation_tables_generate_script();

執行產生的刪除 SQL 陳述式。

使用此 SELECT 陳述式產生全國載入指令碼，如 Loader_Generate_Nation_Script 中詳述

對於 Windows

SELECT loader_generate_nation_script('windows'); 

對於 unix/linux

SELECT loader_generate_nation_script('sh');

請參閱第 2.4.1 節，「Tiger 地理編碼器啟用您的 PostGIS 資料庫」，以取得有關如何執行產生指令碼的指示。這只需要執行一次。

	您可以混合使用不同年份的狀態表，並可單獨升級每個狀態。在升級狀態之前，您需要先使用 Drop_State_Tables_Generate_Script 來刪除該狀態先前年份的狀態表。