第 2 章。PostGIS 安装

从下载网站获取 PostGIS 源存档 https://postgis.net.cn/stuff/postgis-3.4.3dev.tar.gz

wget https://postgis.net.cn/stuff/postgis-3.4.3dev.tar.gz
tar -xvzf postgis-3.4.3dev.tar.gz
cd postgis-3.4.3dev

这将在当前工作目录中创建一个名为 postgis-3.4.3dev 的目录。

或者，从 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 的安装。 如果你以 tar 包的形式获取了 PostGIS，则无需运行 ./autogen.sh，因为 configure 已生成。

生成 Makefile 后，构建 PostGIS 与运行以下命令一样简单

make

输出的最后一行应为 "PostGIS 已成功构建。准备安装。"

从 PostGIS v1.4.0 开始，所有函数都具有从文档中生成的注释。如果你希望稍后将这些注释安装到你的空间数据库中，请运行需要 docbook 的命令。postgis_comments.sql 和其他包注释文件 raster_comments.sql、topology_comments.sql 也打包在 tar.gz 发行版中的 doc 文件夹中，因此如果从 tar 包安装，则无需添加注释。注释还作为 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 包构建，则无需构建注释，因为这些注释已预先打包在 tar 包中。

扩展应在 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 -> extensions 中看到 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.4.3dev         | 3.4.3dev
 address_standardizer_data_us | 3.4.3dev         | 3.4.3dev
 postgis                      | 3.4.3dev         | 3.4.3dev
 postgis_raster               | 3.4.3dev         | 3.4.3dev
 postgis_sfcgal               | 3.4.3dev         |
 postgis_tiger_geocoder       | 3.4.3dev         | 3.4.3dev
 postgis_topology             | 3.4.3dev         |
(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.4.3dev
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.4.3dev
Schema      | tiger
Description | PostGIS tiger geocoder and reverse geocoder
-[ RECORD 4 ]-------------------------------------------------
Name        | postgis_topology
Version     | 3.4.3dev
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.4.3dev，而没有使用我们出色的扩展系统，您可以通过运行以下命令将函数打包到它们各自的扩展中，将其更改为基于扩展的。在 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 geocoder，确保 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，该函数在进行地理编码之前规范化地址以进行准备。规范化器远非完美，而尝试修补其不完美之处需要大量的资源。因此，我们已与另一个具有更好的地址标准化引擎的项目集成。要使用此新地址标准化器，请按照 第 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 Geocoder 启用 PostGIS 数据库”。只需执行一次此操作。

	您可以混合使用不同年份的状态表，并可以分别升级每个州。在升级州之前，您首先需要使用Drop_State_Tables_Generate_Script删除该州的去年状态表。