第 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 扩展包括几何图形、地理、spatial_ref_sys 以及所有函数和注释。栅格和拓扑打包为单独的扩展。

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

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

	如果您不能或不想在 PostgreSQL 扩展目录中安装 PostGIS（例如在测试、开发或受限制的环境中），通常才需要这样做。

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

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

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

如果您收到如下错误通知

No migration path defined for … to 3.5.2dev

那么您需要备份数据库，如 第 3.3.1 节，“使用 EXTENSION 以空间方式启用数据库” 中所述创建一个新的数据库，然后在此新数据库之上还原备份。

如果您收到如下通知消息

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

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

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

	如果您最初安装 PostGIS 时没有指定版本，您通常可以跳过在还原之前重新安装 postgis 扩展，因为备份只具有 CREATE EXTENSION postgis，因此在还原期间会拾取最新的最新版本。

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

3.4.1.2. Pre 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.5.2dev/*_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 硬升级。

具体步骤如下：

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