Chapter 3. PostGIS 管理

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

constraint_exclusion

共享缓冲区

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

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

Maintenance_work_mem - 用于 VACUUM、CREATE INDEX 等的内存大小。

max_parallel_workers_per_gather

此设置仅适用于 PostgreSQL 9.6+，并且只会影响 PostGIS 2.3 +，因为只有 PostGIS 2.3+ 支持并行查询。 如果设置为高于 0，则某些查询（例如涉及 ST_Intersects 等关系函数的查询）可以使用多个进程，并且运行速度可以提高两倍以上。 如果您有大量空闲处理器，则应将其值更改为您拥有的处理器数量。 还要确保将 max_worker_processes 提高到至少与此数字一样高。

如果您使用的是 PostgreSQL 9.1 以上的版本，并且已经编译并安装了 postgis 扩展模块，那么数据库将在 PG 的扩展机制下成为空间数据库。

postgis 的核心扩展包括几何、地理、spatial_ref_sys 以及所有函数和注释。栅格（Raster）和拓扑（Topology）打包为单独的扩展模块。

在要启用空间的数据库中运行以下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 中的各种 sql 文件来完成的。

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

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

如果您希望向 PostGIS 函数添加注释，可以在 postgis_comments.sql 脚本中找到它们。 只需从 psql 终端窗口输入 \dd [function_name] 即可查看注释。

在终端中运行以下 shell 命令：

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

    # 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

如果使用扩展安装数据库，则必须使用扩展模型对其进行升级。 如果使用较旧的 SQL 脚本进行安装，则应切换到扩展，因为不再支持 SQL 脚本。

3.4.1.1. 使用 9.1 或更高版本的扩展进行软升级

如果使用扩展程序安装了PostGIS，则需要使用该扩展程序进行升级。使用扩展程序进行小升级非常轻松。

如果您运行的是 PostGIS 3 或更高版本，则应升级到已安装的具有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.5.0dev";
ALTER EXTENSION postgis_topology UPDATE TO "3.5.0dev";

您可能会看到类似于以下内容的错误通知：

No migration path defined for … to 3.5.0dev

在这种情况下，必须备份数据库，按照 Section 3.3.1, “使用扩展（EXTENSION）启用空间数据库”中所述生成新数据库，然后将备份还原到新数据库。

您可能会收到类似于以下内容的消息：

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

那么一切都已经是最新的，您可以安全地忽略它。 除非您正在尝试从开发版本升级到下一个版本（不会获得新的版本号）； 在这种情况下，您可以将“next”附加到版本字符串，下次您需要再次删除“next”后缀：

ALTER EXTENSION postgis UPDATE TO "3.5.0devnext";
ALTER EXTENSION postgis_topology UPDATE TO "3.5.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

注： 如果要迁移到 r1 之前的 PostGIS 7429.* 或 PostGIS 2.*，则此过程不可用，但需要执行硬升级。

编译并安装（make install）后，您应该在安装文件夹中找到一组 *_upgrade.sql 文件。 您可以通过以下方式列出它们：

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

从 postgis_upgrade.sql 开始依次加载它们。

psql -f postgis_upgrade.sql -d your_spatial_database

相同的过程适用于栅格、拓扑和 sfcgal 扩展，升级文件分别名为 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函数的“进程需要升级”消息提供了有关需要执行此类升级的信息。

硬升级意味着完全转储/重新加载 PostGIS 中可用的数据。如果 PostGIS 对象的内部存储状态发生更改或无法进行软升级，则需要硬升级。 附录中的发行说明指示每个版本是否需要转储/重新加载（硬升级）。

转储/重新加载操作由脚本辅助postgis_restore。 此脚本跳过属于 PostGIS 的所有定义（包括旧定义）。 您还可以将方案和数据恢复到 PostGIS 安装的数据库，而不会传递重复的符号错误或已弃用的对象。

有关 Windows 的其他信息，请参阅 Windows 硬升级。

程序如下：

在以下情况下可能会发生错误：