Chapter 2. PostGIS 安装

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

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

这将在当前工作目录中创建一个名为 postgis-3.7.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.”，则表示您已完成

所有函数的注释都是根据文档自动生成的。如果你之后想把这些注释安装到自己的空间数据库里，需要运行依赖 docbook 的命令来导入注释。不过，如果是从 tar.gz 包安装，doc 目录里已经包含了 postgis_comments.sql 等注释文件，就不需要再额外生成了；另外，通过 CREATE EXTENSION 安装时，这些注释也会一并包含在内。

make comments

make cheatsheets 目标会生成 HTML 格式的速查表，适合快速查阅或教学讲义使用。这一步需要 xsltproc 来构建，并会在 doc 目录下生成 4 个文件：topology_cheatsheet.html、tiger_geocoder_cheatsheet.html、raster_cheatsheet.html、postgis_cheatsheet.html

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

make cheatsheets

当 PostgreSQL 提供扩展支持时，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二进制文件，就可以将扩展文件从一个操作系统复制到另一个操作系统。

如果您想在与开发环境不同的另一台服务器上手动安装扩展，除了通常需要的PostGIS二进制文件之外，还需要将以下文件从 extensions 文件夹复制到 PostgreSQL 安装目录下的 PostgreSQL/share/extension 文件夹中。

完成这一步后，你应该在 PgAdmin> 中看到 postgis、postgis_topology 作为可用的扩展。

如果使用 psql，则可以运行以下查询来验证是否已安装扩展：

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

             name             | default_version | installed_version
------------------------------+-----------------+-------------------
 postgis                      | 3.7.0dev         | 3.7.0dev
 postgis_raster               | 3.7.0dev         | 3.7.0dev
 postgis_sfcgal               | 3.7.0dev         |
 postgis_tiger_geocoder       | 3.7.0dev         | 3.7.0dev
 postgis_topology             | 3.7.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
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.7.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.7.0dev
Schema      | tiger
Description | PostGIS tiger geocoder and reverse geocoder
-[ RECORD 4 ]-------------------------------------------------
Name        | postgis_topology
Version     | 3.7.0dev
Schema      | topology
Description | PostGIS topology spatial types and functions

	扩展表 spatial_ref_sys、layer、topology 不能单独备份。只有在备份对应的 postgis 或 postgis_topology 扩展时才会一起备份，而这只会在你备份整个数据库时发生。备份中只会包含那些 不是 PostGIS 自带的 srid 记录，所以不要修改我们随 PostGIS 一起提供的条目并指望修改能长期保留——如果发现问题，请提交工单。扩展表的结构永远不会出现在备份里，因为它们是通过 CREATE EXTENSION 创建的，在同一扩展版本下默认结构是一致的。这些行为属于当前 PostgreSQL 扩展模型的固有机制。

如果你在没有使用扩展系统的情况下安装了3.7.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。 或者为不可避免的麻烦做好准备。

	沙箱式构建账号（非 PostgreSQL 超级用户）在回归测试周期中，可以通过导出 POSTGIS_REGRESS_DB_OWNER 来委托数据库所有权。测试框架会创建一个临时的回归测试库，并将其所有者设为指定的角色，同时仍然使用权限更低的账号进行连接。如果扩展的创建角色需要与数据库所有者不同，可以再配合使用 POSTGIS_REGRESS_ROLE_EXT_CREATOR。 这些变量的作用是：在目标 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

The postgis_tiger_geocoder extension, currently only supports the standard PostgreSQL installcheck. To test these use the below. Note: the make install is not necessary if you already did make install at root of PostGIS code folder.

For tiger geocoder, make sure you have postgis and fuzzystrmatch extensions available in your PostgreSQL instance.

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
============== running regression test queries        ==============
test test-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 的外部依赖关系，因此它与正常的构建和安装分离。

加载过程从人口普查网站下载各个国家文件、所请求的州的数据，提取文件，然后将每个州加载到其自己单独的一组州表中。每个状态表都继承自 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.3.1, “在 PostGIS 数据库中启用Tiger地理编码器”。 您只需要执行此操作一次。

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