第 3 章。PostGIS 管理

这些设置在 postgresql.conf 中配置

constraint_exclusion

shared_buffers

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+ 并且已经编译并安装了 extensions/postgis 模块，您可以使用 EXTENSION 机制将数据库转换为空间数据库。

核心 postgis 扩展包括 geometry、geography、spatial_ref_sys 以及所有函数和注释。栅格和拓扑作为单独的扩展进行打包。

在您要启用空间功能的数据库中运行以下 SQL 代码段

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

	这通常仅在您无法或不想将 PostGIS 安装在 PostgreSQL 扩展目录中时才需要（例如在测试、开发或受限环境中）。

通过加载构建阶段指定的 [prefix]/share/contrib 中的各种 sql 文件，将 PostGIS 对象和函数定义添加到您的数据库中。

核心 PostGIS 对象（geometry 和 geography 类型及其支持函数）位于 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.3/

    # 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 脚本方式安装，建议您将安装切换到扩展，因为脚本方式不再受支持。

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.4.3dev";
ALTER EXTENSION postgis_topology UPDATE TO "3.4.3dev";

如果您收到类似以下的错误通知

No migration path defined for … to 3.4.3dev

那么您需要备份您的数据库，创建一个新的数据库，如 第 3.3.1 节，“使用 EXTENSION 使数据库具有空间功能” 中所述，然后将您的备份恢复到这个新数据库上。

如果您收到类似以下的通知消息

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

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

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

	如果您最初安装 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.* 或从 r7409 之前的 PostGIS 2.* 迁移，则无法使用此过程，而是需要进行 硬升级。

编译和安装（make install）后，您应该在安装文件夹中找到一组 *_upgrade.sql 文件。您可以使用以下命令列出所有文件：

ls `pg_config --sharedir`/contrib/postgis-3.4.3dev/*_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 函数应通过“procs need upgrade”消息通知您是否需要运行此类升级。

硬升级是指对启用 PostGIS 的数据库进行完全的转储/重新加载。当 PostGIS 对象的内部存储发生更改或无法进行软升级时，您需要进行硬升级。 发行说明 附录报告每个版本是否需要转储/重新加载（硬升级）以进行升级。

转储/重新加载过程由 postgis_restore 脚本辅助，该脚本负责跳过转储中属于 PostGIS 的所有定义（包括旧的定义），允许您将模式和数据还原到已安装 PostGIS 的数据库中，而不会出现重复符号错误或将已弃用的对象带回。

Windows 用户的补充说明可在 Windows 硬升级 中找到。

过程如下

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