Chapter 2. PostGIS 安装

从下载站点 https://postgis.net/stuff/postgis-3.5.0dev.tar.gz 获取源代码的存档

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

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

或者从 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 此脚本生成配置脚本。这用于自定义 PostGIS 安装。 如果要获取 PostGIS 作为存档文件，则无需./autogen.sh，因为 配置已经生成。

生成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 是必需的，生成 4 个文件。topology_cheatsheet.html,tiger_geocoder_cheatsheet.html,raster_cheatsheet.html, postgis_cheatsheet.html

预构建的HTML和PDF版本可以在PostGIS / PostgreSQL学习指南中找到

make cheatsheets

如果您使用的是 PostgreSQL 9.1 或更高版本，则会自动构建并安装PostGIS 扩展。

如果要从源存储库构建，则必须先构建函数描述。这些是在安装文档手册时构建的。 您也可以手动安装：

make comments

如果从存档文件构建，则其中一些注释文件已经构建，因此无需构建注释。

如果您针对 PostgreSQL 9.1 进行构建，则应在 make 安装过程中自动构建扩展。如果需要，可以从扩展文件夹生成，或者根据需要在另一台服务器上复制该文件。

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 中始终相同。只要已安装 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.0dev         | 3.5.0dev
 address_standardizer_data_us | 3.5.0dev         | 3.5.0dev
 postgis                      | 3.5.0dev         | 3.5.0dev
 postgis_raster               | 3.5.0dev         | 3.5.0dev
 postgis_sfcgal               | 3.5.0dev         |
 postgis_tiger_geocoder       | 3.5.0dev         | 3.5.0dev
 postgis_topology             | 3.5.0dev         |
(6 rows)

如果您正在查询的数据库中安装了扩展程序，您将在 installed_version 列中看到提及。 如果您没有收到任何记录，则意味着您的服务器上根本没有安装 postgis 扩展。 PgAdmin III 1.14+ 还将在数据库浏览器树的扩展 部分中提供此信息，甚至允许通过右键单击进行升级或卸载。

如果您有有效的扩展，则可以使用 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.0dev
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.0dev
Schema      | tiger
Description | PostGIS tiger geocoder and reverse geocoder
-[ RECORD 4 ]-------------------------------------------------
Name        | postgis_topology
Version     | 3.5.0dev
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.0dev版本，你可以通过运行以下命令将其转换为基于扩展的安装方式，以将函数打包到各自的扩展中。在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。编辑路径以匹配在配置期间检测到的 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 and address_standardizer 扩展目前仅支持标准的 PostgreSQL 安装检查。要测试这些，请使用以下命令。注意：如果您已经在 PostGIS 代码文件夹的根目录中进行了安装，则不需要进行安装。

对于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 注释，请运行以下命令来安装这些 SQL 文件：postgis_comments.sql,raster_comments.sql

make comments-install

	postgis_comments.sql, raster_comments.sql, topology_comments.sql成为 xsltproc 的外部依赖关系，因此它与正常的构建和安装分离。

您可能认为有问题的众多事情之一是在地理编码之前进行格式化地址的Normalize_Address 函数。地址规范化远非完美，修补它可能会占用大量资源。 因此，我们将其集成到其他项目中，具有更好的地址标准化引擎。要使用此新的地址标准化，请按照Section 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;

然后删除所有国家/地区表并加载新的国家/地区表。 如Drop_Nation_Tables_Generate_Script中所述，使用此 SQL 语句生成删除脚本

SELECT drop_nation_tables_generate_script();

执行生成的删除SQL语句。

如Loader_Generate_Nation_Script中所述，使用此 SELECT 语句生成删除脚本

对于Windows

SELECT loader_generate_nation_script('windows'); 

对于unix/linux

SELECT loader_generate_nation_script('sh');

有关如何运行生成脚本的说明，请参见 Section 2.4.1, “在 PostGIS 数据库中启用Tiger地理编码器”。 您只需要执行此操作一次。

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