Chapter 3. PostGIS 管理

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

constraint_exclusion

共享缓冲区

max_worker_processes controls the maximum number of background processes available to the server and therefore also bounds how many workers can participate in parallel queries.

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

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

max_parallel_workers_per_gather

Parallel query support in modern PostgreSQL and PostGIS uses this setting to decide how many workers a plan may request. If set to higher than 0, then some queries such as those involving relation functions like ST_Intersects can use multiple processes and can run more than twice as fast when doing so. If you have a lot of processors to spare, you should change the value of this to as many processors as you have. Also make sure to bump up max_worker_processes to at least as high as this number.

If you have compiled and installed the extensions/postgis modules, you can turn a database into a spatial one using the EXTENSION mechanism.

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.6/

    # 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. Soft upgrade using extensions

If you originally installed PostGIS with extensions, then you need to upgrade using extensions as well. Doing a minor upgrade with extensions is fairly painless.

Use the PostGIS_Extensions_Upgrade function to upgrade to the latest version you have installed.

SELECT postgis_extensions_upgrade();

If you are upgrading a database that still runs PostGIS 2.5, issue an ALTER EXTENSION followed by postgis_extensions_upgrade() to make sure the legacy postgis_raster objects are folded back into the main extension.

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

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

No migration path defined for … to 3.7.0dev

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

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

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

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

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

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

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