Chapter 2. PostGIS安装

Retrieve the PostGIS source archive from the downloads website http://postgis.net/stuff/postgis-3.3.0dev.tar.gz

wget http://postgis.net/stuff/postgis-3.3.0dev.tar.gz
tar -xvzf postgis-3.3.0dev.tar.gz

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

或者，从 吉特 存储库 https://git.osgeo.org/gitea/postgis/postgis/ 。

git clone https://git.osgeo.org/gitea/postgis/postgis.git postgis

更改为新创建的 postgis 目录以继续安装。

PostGIS对构建和使用有以下要求：

必填项

可选

与大多数Linux安装一样，第一步是生成将用于构建源代码的Makefile。这是通过运行外壳脚本来完成的

./configure

在没有附加参数的情况下，该命令将尝试自动定位在您的系统上构建PostGIS源代码所需的组件和库。尽管这是最常见的 ./configure 对于那些在非标准位置拥有所需的库和程序的用户，该脚本接受几个参数。

以下列表仅显示最常用的参数。有关完整列表，请使用 --help 或 --help=short 参数。

	如果您是从 代码库 ，第一步是真正运行脚本 ./autogen.sh 此脚本将生成 configure 脚本，而该脚本又用于定制PostGIS的安装。 如果您以tarball的形式获取了PostGIS，运行 ./autogen.sh 不是必需的，因为 configure 已经生成了。

生成Makefile后，构建PostGIS就像运行

make

输出的最后一行应该是“ PostGIS was built successfully. Ready to install. “

从PostGISv1.4.0开始，所有函数都有从文档生成的注释。如果您希望稍后将这些注释安装到空间数据库中，请运行需要docbook的命令。Postgis_Comments.sql和其他包注释文件raster_Comments.sql、topology_Comments.sql也打包在文档文件夹中的tar.gz分发包中，因此如果从tar ball安装，则不需要做任何注释。注释也是创建扩展安装的一部分。

发表评论

在PostGIS 2.0中引入。这将生成适合快速参考或学生讲义的html作弊单。这需要xsltproc来构建，并将在文档文件夹中生成4个文件 topology_cheatsheet.html ， tiger_geocoder_cheatsheet.html ， raster_cheatsheet.html ， postgis_cheatsheet.html

您可以从以下地址下载一些预构建的文档：html和pdf PostGIS/PostgreSQL学习指南

制作小抄

如果您使用的是PostgreSQL 9.1+，则会自动构建和安装PostGIS扩展。

如果您是从源代码库构建，则需要首先构建函数描述。如果您安装了Docbook，就会构建这些文档。您还可以使用以下语句手动构建：

发表评论

如果您是从发布焦油球构建的，那么构建注释是不必要的，因为它们已经与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 / share / extension 您的PostgreSQL安装的文件夹，以及常规PostGIS所需的二进制文件(如果服务器上还没有它们的话)。

一旦你这样做了，你应该会看到 postgis ， postgis_topology 作为PgAdmin->扩展中的可用扩展。

如果您使用的是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.3.0dev         | 3.3.0dev
 address_standardizer_data_us | 3.3.0dev         | 3.3.0dev
 postgis                      | 3.3.0dev         | 3.3.0dev
 postgis_raster               | 3.3.0dev         | 3.3.0dev
 postgis_sfcgal               | 3.3.0dev         |
 postgis_tiger_geocoder       | 3.3.0dev         | 3.3.0dev
 postgis_topology             | 3.3.0dev         |
(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.3.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.3.0dev
Schema      | tiger
Description | PostGIS tiger geocoder and reverse geocoder
-[ RECORD 4 ]-------------------------------------------------
Name        | postgis_topology
Version     | 3.3.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.3.0dev ，在不使用我们出色的扩展系统的情况下，您可以通过运行以下命令将函数打包到各自的扩展中，从而将其更改为基于扩展的。安装使用 `unpackaged` 已在PostgreSQL 13中删除，因此建议您在升级到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构建，请运行

勾选

上面的命令将使用生成的库对实际的PostgreSQL数据库运行各种检查和回归测试。

	如果使用非标准的PostgreSQL、GEOS或Proj位置配置了PostGIS，则可能需要将它们的库位置添加到 LD_LIBRARY_PATH 环境变量。

	目前， make check 依赖于 PATH 和 PGPORT 执行检查时的环境变量-它确实如此 不 使用可能已使用配置参数指定的PostgreSQL版本 --with-pgconfig 。因此，确保在配置期间修改路径以匹配检测到的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安装检查。要测试这些功能，请使用以下代码。注意：如果您已经在PostGIS代码文件夹的根目录下进行了安装，则不需要进行Make Install。

对于ADDRESS_STANDIZER：

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扩展。如果您构建的postgis支持ADDRESS_STANDIZER，则ADDRESS_STANDAREZER测试也会生效：

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，请输入

制造安装

这会将PostGIS安装文件复制到由指定的相应子目录中 --prefix 配置参数。特别是：

如果您以前运行过 make comments 命令来生成 postgis_comments.sql ， raster_comments.sql 文件中，通过运行以下命令安装SQL文件

发表评论-安装

	postgis_comments.sql ， raster_comments.sql ， topology_comments.sql 从典型的构建和安装目标中分离出来，因为随之而来的是对 xsltproc 。

Perl Regex：编译ADDRESS_STANDAREZER扩展不再需要ASSEMBLE，因为它生成的文件是源代码树的一部分。但是，如果您需要编辑 usps-st-city-orig.txt 或 usps-st-city-orig.txt usps-st-city-adds.tx ，你需要重建 parseaddress-stcities.h 这确实需要Regex：组装。

cpan Regexp::Assemble

或者，如果您使用的是Ubuntu/Debian，您可能需要这样做

sudo perl -MCPAN -e "install Regexp::Assemble"

如果您使用的是PostgreSQL9.1+和PostGIS2.1+，您可以利用新的扩展模型来安装Tiger Geocoder。要执行此操作，请执行以下操作：

首先按照前面的说明安装PostGIS。

如果您没有附加文件夹，请下载 http://postgis.net/stuff/postgis-3.3.0dev.tar.gz

TAR xvfz postgis- 3.3.0dev .tar.gz

CD Postgis- 3.3.0dev /extras/tiger_geocoder

编辑 tiger_loader_2015.sql (或您找到的最新加载程序文件，除非您想加载不同的年份)到您的可执行文件服务器的路径等，或者您也可以更新 loader_platform 表一旦安装。如果您不编辑此文件或 loader_platform 表中，它将只包含项的常见用例位置，并且您必须在运行 Loader_Generate_Nation_Script 和 Loader_Generate_Script SQL函数。

如果您是第一次安装Tiger Geocoder，请编辑 create_geocode.bat 如果您使用的是Windows或 create_geocode.sh 如果您在Linux/Unix/Mac OSX上使用您的PostgreSQL特定设置，并从命令行运行相应的脚本。

验证您现在是否拥有 tiger 模式，并且它是数据库Search_PATH的一部分。如果不是，则使用以下行的命令添加它：

ALTER DATABASE geocoder SET search_path=public, tiger;

标准化地址功能或多或少地在没有任何数据的情况下工作，除了棘手的地址。运行此测试并验证情况如下：

SELECT pprint_addy(normalize_address('202 East Fremont Street, Las Vegas, Nevada 89101')) As pretty_address;
pretty_address
---------------------------------------
202 E Fremont St, Las Vegas, NV 89101
                        

人们抱怨的众多问题之一是地址归一化功能 Normalize_Address 在进行地理编码之前对地址进行标准化以进行准备的功能。规格化器远不是完美的，试图修补其不完美需要大量的资源。因此，我们已经与另一个具有更好的地址标准化引擎的项目进行了集成。要使用这个新的ADDRESS_STANDAREZER，请按照中所述编译扩展 Section 2.3, “安装和使用地址标准化程序” 并作为扩展安装在您的数据库中。

在已安装的数据库中安装此扩展模块后 postgis_tiger_geocoder ，然后 Pagc_Normalize_Address 可以用来代替 Normalize_Address 。该扩展与Tiger无关，因此可以与其他数据源一起使用，例如国际地址。Tiger地理编码器扩展模块与其自己的自定义版本打包在一起 规则表 ( tiger.pagc_rules )、 GAZ表 ( tiger.pagc_gaz )，以及 Lex表 ( tiger.pagc_lex )。您可以添加和更新这些，以改善您的标准化体验，以满足您自己的需求。

加载数据的说明以更详细的形式在 extras/tiger_geocoder/tiger_2011/README 。这只包括一般步骤。

加载过程从人口普查网站下载所请求的各个国家文件、州的数据，提取文件，然后将每个州加载到其自己的一组单独的州表中。每个状态表继承自中定义的表 tiger 模式，因此只需查询这些表即可访问所有数据，并在任何时候使用 Drop_State_Tables_Generate_Script 如果您需要重新加载状态，或者只是不再需要状态。

为了能够加载数据，您需要以下工具：

如果要从Tiger_2010升级，则需要首先生成并运行 Drop_Nation_Tables_Generate_Script 。在加载任何州数据之前，您需要加载全国范围的数据 Loader_Generate_Nation_Script 。它将为您生成一个加载器脚本。 Loader_Generate_Nation_Script 这是升级(从2010年起)和新安装时应该完成的一次性步骤。

要加载状态数据，请参阅 Loader_Generate_Script 为您的平台生成所需状态的数据加载脚本。请注意，您可以逐个安装这些组件。您不必一次加载您想要的所有状态。您可以在需要时加载它们。

加载所需的状态后，请确保运行：

 选择INSTALL_MISSING_INDEX()； 

如中所述 Install_Missing_Indexes 。

要测试是否正常运行，请尝试使用以下命令对您所在州的地址运行地理编码 地理编码

如果你已经安装了2.0+的Tiger Geocode包，你可以在任何时候升级功能，即使是从临时的焦油球，如果有你迫切需要的修复程序。这将仅适用于未安装扩展的Tiger Geocoder。

如果您没有附加文件夹，请下载 http://postgis.net/stuff/postgis-3.3.0dev.tar.gz

TAR xvfz postgis- 3.3.0dev .tar.gz

CD Postgis- 3.3.0dev /extras/tiger_geocoder/tiger_2011

找到 upgrade_geocoder.bat 如果您使用的是Windows或 upgrade_geocoder.sh 如果您使用的是Linux/Unix/Mac OSX。编辑该文件以拥有您的Postgis数据库凭据。

如果要从2010或2011升级，请确保取消对加载器脚本行的注释，以便获得用于加载2012年数据的最新脚本。

然后从命令行运行相应的脚本。

接下来，删除所有的国家表并加载新的表。使用此SQL语句生成删除脚本，详细信息请参见 Drop_Nation_Tables_Generate_Script

SELECT drop_nation_tables_generate_script();

运行生成的DROP SQL语句。

使用此SELECT语句生成国家加载脚本，详细信息请参见 Loader_Generate_Nation_Script

对于Windows

SELECT loader_generate_nation_script('windows'); 

适用于Unix/Linux

SELECT loader_generate_nation_script('sh');

请参阅 Section 2.4.4, “正在加载TIGER数据” 以获取有关如何运行生成脚本的说明。这只需要做一次。

	您可以混合使用2010/2011州表，并且可以分别升级每个州。在将一个州升级到2011年之前，首先需要使用以下命令删除该州的2010个表 Drop_State_Tables_Generate_Script 。