Chapter 3. PostGIS管理

这些设置在中配置 postgresql.conf ：

constraint_exclusion

shared_buffers

max_worker_processes 此设置仅适用于PostgreSQL 9.4+。对于PostgreSQL 9.6+，此设置具有额外的重要性，因为它控制您可以拥有的并行查询的最大进程数。

work_mem -设置用于排序操作和复杂查询的内存大小

maintenance_work_mem -真空、创建索引等使用的内存大小。

max_parallel_workers_per_gather

此设置仅适用于PostgreSQL 9.6+，并且只会影响PostGIS 2.3+，因为只有PostGIS 2.3+支持并行查询。如果设置为大于0，则某些查询(如涉及关系函数的查询)如下 ST_Intersects 可以使用多个进程，并且运行速度是多个进程的两倍以上。如果您有很多处理器可供备用，则应该将此值更改为您所拥有的处理器数量。也要确保你的身体健康 max_worker_processes 至少和这个数字一样高。

如果您使用的是PostgreSQL9.1+，并且已经编译和安装了扩展/postgis模块，则可以使用扩展机制将数据库转换为空间数据库。

核心的Postgis扩展包括几何、地理、空间参考系统以及所有的函数和注释。栅格和拓扑被打包为单独的扩展。

在要在空间上启用的数据库中运行以下SQL代码片段：

CREATE EXTENSION IF NOT EXISTS plpgsql;
      CREATE EXTENSION postgis;
      CREATE EXTENSION postgis_raster; -- OPTIONAL
      CREATE EXTENSION postgis_topology; -- OPTIONAL

	通常只有当您不能或不想在PostgreSQL扩展目录中安装PostGIS时(例如，在测试、开发期间或在受限环境中)，才需要这样做。

将PostGIS对象和函数定义添加到数据库中的方法是加载位于 [prefix]/share/contrib 如在构建阶段指定的。

核心PostGIS对象(几何和地理类型及其支持函数)位于 postgis.sql 剧本。栅格对象位于 rtpostgis.sql 剧本。拓扑对象位于 topology.sql 剧本。

对于一组完整的EPSG坐标系定义标识符，还可以将 spatial_ref_sys.sql 定义文件并填充 spatial_ref_sys 数据表。这将允许您对几何体执行ST_Transform()操作。

如果您想要向PostGIS函数添加注释，可以在 postgis_comments.sql 剧本。只需输入以下内容即可查看评论 \dd [function_name] 从一个 psql 终端窗口。

在您的终端中运行以下外壳命令：

DB=[yourdatabase]
    SCRIPTSDIR=`pg_config --sharedir`/contrib/postgis-3.2/

    # Core objects
    psql -d ${DB} -f ${SCRIPTSDIR}/postgis.sql
    psql -d ${DB} -f ${SCRIPTSDIR}/spatial_ref_sys.sql
    psql -d ${DB} -f ${SCRIPTSDIR}/postgis_comments.sql # OPTIONAL

    # Raster support (OPTIONAL)
    psql -d ${DB} -f ${SCRIPTSDIR}/rtpostgis.sql
    psql -d ${DB} -f ${SCRIPTSDIR}/raster_comments.sql # OPTIONAL

    # Topology support (OPTIONAL)
    psql -d ${DB} -f ${SCRIPTSDIR}/topology.sql
    psql -d ${DB} -f ${SCRIPTSDIR}/topology_comments.sql # OPTIONAL

一些打包的PostGIS发行版(特别是用于PostGIS的Win32安装程序 > =1.1.5)将PostGIS函数加载到名为 template_postgis 。如果 template_postgis 数据库存在于您的PostgreSQL安装中，则用户和/或应用程序可以使用单个命令创建空间启用的数据库。请注意，在这两种情况下，数据库用户都必须被授予创建新数据库的权限。

从外壳中：

# createdb -T template_postgis my_spatial_db

来自SQL：

postgres=# CREATE DATABASE my_spatial_db TEMPLATE=template_postgis

如果您使用扩展安装数据库，则还需要使用扩展模型进行升级。如果您使用旧的SQL脚本方式安装，建议您将安装切换到扩展，因为脚本方式不再受支持。

3.4.1.1. 使用扩展的软件升级9.1+

如果您最初安装的是带有扩展的PostGIS，那么您也需要使用扩展进行升级。用扩展进行一个小的升级是相当容易的。

如果您运行的是PostGIS3或更高版本，则应使用 PostGIS_Extensions_Upgrade 功能可升级到您已安装的最新版本。

SELECT postgis_extensions_upgrade();

如果您运行的是PostGIS 2.5或更低版本，请执行以下操作：

ALTER EXTENSION postgis UPDATE;
SELECT postgis_extensions_upgrade();
-- This second call is needed to rebundle postgis_raster extension
SELECT postgis_extensions_upgrade();

如果您安装了多个版本的PostGIS，并且不想升级到最新版本，则可以按如下方式明确指定版本：

ALTER EXTENSION postgis UPDATE TO "3.3.0dev";
ALTER EXTENSION postgis_topology UPDATE TO "3.3.0dev";

如果收到类似以下内容的错误通知：

No migration path defined for … to 3.3.0dev

然后，您需要备份数据库，创建一个新的数据库，如中所述 Section 3.3.1, “使用扩展在空间上启用数据库” 然后在这个新数据库上恢复备份。

如果您收到如下通知消息：

Version "3.3.0dev" of extension "postgis" is already installed

那么一切都已经是最新的，您可以放心地忽略它。 UNLESS 您正在尝试从开发版本升级到下一个版本(没有获得新的版本号)；在这种情况下，您可以在版本字符串后附加“Next”，下一次您将需要再次删除“Next”后缀：

ALTER EXTENSION postgis UPDATE TO "3.3.0devnext";
ALTER EXTENSION postgis_topology UPDATE TO "3.3.0devnext";

	如果最初安装的PostGIS没有指定版本，则在恢复之前通常可以跳过重新安装postgis扩展模块，因为备份刚刚 CREATE EXTENSION postgis 从而在恢复期间获取最新的最新版本。

	如果要从3.0.0之前的版本升级PostGIS扩展模块，您将拥有一个新的扩展模块 postgis_raster 如果您不需要栅格支持，则可以安全地将其删除。您可以按如下方式删除： DROP EXTENSION postgis_raster;

3.4.1.2. 9.1+版或无扩展版的软件升级

本节仅适用于安装了未使用扩展的PostGIS的用户。如果您有扩展并尝试使用此方法进行升级，您将收到如下消息：

can't drop … because postgis extension depends on it

注意：如果要从PostGIS 1.*迁移到PostGIS 2.*或从PostGIS 2.*迁移到r7409之前的版本，则不能使用此过程，而是需要执行 硬升级 。

在编译和安装(Make Install)之后，您应该会找到一组 *_upgrade.sql 安装文件夹中的文件。您可以使用以下命令将它们全部列出：

ls `pg_config --sharedir`/contrib/postgis-3.3.0dev/*_upgrade.sql

依次加载它们，从 postgis_upgrade.sql 。

psql -f postgis_upgrade.sql -d your_spatial_database

同样的过程也适用于栅格、拓扑和sfcga扩展模块，升级文件的名称为 rtpostgis_upgrade.sql ， topology_upgrade.sql 和 sfcgal_upgrade.sql 分别为。如果需要，请执行以下操作：

psql -f rtpostgis_upgrade.sql -d your_spatial_database

psql -f topology_upgrade.sql -d your_spatial_database

psql -f sfcgal_upgrade.sql -d your_spatial_database

建议您通过运行以下命令切换到基于扩展的安装

psql -c "SELECT postgis_extensions_upgrade();"

	如果您找不到 postgis_upgrade.sql 特定于升级您的版本您正在使用的版本对于软升级来说太早了，并且需要执行 硬升级 。

这个 PostGIS_Full_Version 函数应使用“PROCS Need Upgrade”消息通知您是否需要运行此类升级。

我们所说的硬升级是指完全转储/重新加载启用了postgis的数据库。当PostGIS对象的内部存储发生变化或无法进行软升级时，您需要进行硬升级。这个 发行说明 附录报告了每个版本是否需要转储/重新加载(硬升级)才能升级。

转储/重新加载过程得到postgis_Restore.pl脚本的帮助，该脚本负责从转储跳过属于PostGIS(包括旧定义)的所有定义，允许您将模式和数据恢复到安装了PostGIS的数据库中，而不会出现重复的符号错误或转发不推荐使用的对象。

有关Windows用户的补充说明，请访问 Windows硬件升级 。

具体步骤如下：

在以下情况下可能会出现错误：