第 2 章。PostGIS 安装

从下载网站检索 PostGIS 源代码存档 https://postgis.net.cn/stuff/postgis-3.5.2dev.tar.gz

wget https://postgis.net.cn/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 也打包在 doc 文件夹的 tar.gz 发行版中，因此如果从 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 二进制文件，就可以将扩展文件从一个操作系统复制到另一个操作系统。

如果您想在与开发环境不同的单独服务器上手动安装扩展，则需要将以下文件从 extensions 文件夹复制到 PostgreSQL 安装的 PostgreSQL / share / extension 文件夹中，以及 regular 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 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，该函数标准化地址以进行地理编码前的准备。标准化工具远非完美，并且尝试修补其不完善之处需要大量的资源。因此，我们与另一个项目集成，该项目具有更好的地址标准化引擎。要使用此新的 address_standardizer，请按照 第 2.3 节，“安装和使用地址标准化工具”中所述编译扩展，并将其作为扩展安装在您的数据库中。

一旦您将此扩展安装在与安装了 postgis_tiger_geocoder 的同一数据库中，则可以使用 Pagc_Normalize_Address 来代替 Normalize_Address。此扩展与 tiger 无关，因此可以与其他数据源（例如国际地址）一起使用。tiger 地理编码器扩展的确附带了其自己自定义版本的 rules table（tiger.pagc_rules）、gaz table（tiger.pagc_gaz）和 lex table（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删除该州之前年份的州表。