通过本地升级模式升级大版本

大版本升级期间不支持变更实例，必须在大版本升级完成后才能进行其他操作。

暂不支持自动升级数据库大版本。

升级后暂不支持进行大版本降级操作，如需降级，请购买低版本实例后，使用DTS迁移，将实例迁移至低版本中。

如果PostGIS版本小于2.5.2且RDS PostgreSQL版本为10或11，升级插件后，再升级数据库大版本到PostgreSQL12，在新实例中创建raster_overviews视图可能会出现raster_overviews冲突的问题。

解决方法如下：

1. 在原实例中升级PostGIS插件版本。

   如下命令需执行两遍，以确保成功。

   SELECT PostGIS_Extensions_Upgrade();
   SELECT PostGIS_Extensions_Upgrade();

2. 根据业务判断是否使用了PostGIS Raster插件，选择对应的升级方法。

   使用了PostGIS Raster插件

   1. 在原实例中执行如下命令，修改raster_overviews视图。

      ALTER EXTENSION PostGIS_Raster DROP VIEW raster_overviews;
      CREATE OR REPLACE VIEW raster_overviews AS SELECT 1;

   2. 对PostgreSQL实例进行大版本升级，至少升级到PostgreSQL 12或以上版本。

   3. 升级完成后，在新实例中重新创建视图。

      CREATE 
      OR REPLACE VIEW raster_overviews AS 
      SELECT 
        current_database() AS o_table_catalog, 
        n.nspname AS o_table_schema, 
        c.relname AS o_table_name, 
        a.attname AS o_raster_column, 
        current_database() AS r_table_catalog, 
        split_part(
          split_part(s.consrc, '''::name', 1), 
          '''', 
          2
        ): :name AS r_table_schema, 
        split_part(
          split_part(s.consrc, '''::name', 2), 
          '''', 
          2
        ): :name AS r_table_name, 
        split_part(
          split_part(s.consrc, '''::name', 3), 
          '''', 
          2
        ): :name AS r_raster_column, 
        trim(
          both 
          from 
            split_part(s.consrc, ',', 2)
        ): :integer AS overview_factor 
      FROM 
        pg_class c, 
        pg_attribute a, 
        pg_type t, 
        pg_namespace n, 
        (
          SELECT 
            connamespace, 
            conrelid, 
            conkey, 
            pg_get_constraintdef(oid) As consrc 
          FROM 
            pg_constraint
        ) AS s 
      WHERE 
        t.typname = 'raster' : :name 
        AND a.attisdropped = false 
        AND a.atttypid = t.oid 
        AND a.attrelid = c.oid 
        AND c.relnamespace = n.oid 
        AND c.relkind = ANY(
          ARRAY[ 'r' : :char, 'v' : :char, 'm' : :char, 
          'f' : :char ]
        ) 
        AND s.connamespace = n.oid 
        AND s.conrelid = c.oid 
        AND s.consrc LIKE '%_overview_constraint(%' 
        AND NOT pg_is_other_temp_schema(c.relnamespace) 
        AND has_table_privilege(c.oid, 'SELECT' : :text); ALTER EXTENSION PostGIS_Raster 
      ADD 
        VIEW raster_overviews;

   未使用PostGIS Raster插件

   1. 在原实例中执行如下命令删除插件。

      DROP EXTENSION PostGIS_Raster;

   2. 对PostgreSQL实例进行大版本升级，至少升级到PostgreSQL 12或以上版本。

• 如果您需要将订阅数据保留在源端（低版本实例），那么在升级的过程中，确保源端不会因负载过大而导致宕机。否则，可能导致复制槽被目标端（高版本实例）抢占，从而出现数据不一致的情况。

  升级完成后，请使用以下SQL语句在目标端的数据库关闭订阅。

  \c your_database
  ALTER SUBSCRIPTION your_subscription_name DISABLE;

• 如果您需要将订阅数据保存在目标端，请在升级前关闭源端的订阅，再进行大版本升级，升级完成后，请打开目标端的订阅。SQL示例如下：

  • 在源端关闭订阅。

    \c your_database
    ALTER SUBSCRIPTION your_subscription_name DISABLE;

  • 在目标端开启订阅。

    \c your_database
    ALTER SUBSCRIPTION your_subscription_name ENABLE;

1. 升级成功后，清空目标端（高版本实例）表数据，重新创建订阅并设置copy_data=true。详情请参见ALTER SUBSCRIPTION。

2. 使用CONFLICT关键字将源端（低版本实例）消费的数据导入到目标端，示例如下。

   CREATE TABLE my_tbl(id INT PRIMARY KEY, t TIMESTAMP, val TEXT);
   
   INSERT INTO my_tbl VALUES (1, CURRENT_TIMESTAMP, 'a');
   INSERT INTO my_tbl VALUES (2, CURRENT_TIMESTAMP, 'b');
   INSERT INTO my_tbl VALUES (3, CURRENT_TIMESTAMP, 'c');
   
   -- in case with newer timestamp: do update
   INSERT INTO my_tbl VALUES (1, CURRENT_TIMESTAMP, 'd') ON CONFLICT(id) DO UPDATE
   	SET t = excluded.t,
   		val = excluded.val
   	WHERE my_tbl.t < excluded.t;
   
   -- in case with older timestamp: do nothing
   INSERT INTO my_tbl VALUES (2, CURRENT_TIMESTAMP - '10 hours'::interval, 'e') ON CONFLICT(id) DO UPDATE
   	SET t = excluded.t,
   		val = excluded.val
   	WHERE my_tbl.t < excluded.t;
   
   -- in case with new val: just insert
   INSERT INTO my_tbl VALUES (5, CURRENT_TIMESTAMP - '10 hours'::interval, 'f') ON CONFLICT(id) DO UPDATE
   	SET t = excluded.t,
   		val = excluded.val
   	WHERE my_tbl.t < excluded.t;

升级完成后，自建的只读节点和复制槽在升级后仍然保留在原实例下，不会自动转移到高版本实例。因此，在进行大版本升级前，请将应用程序中配置的只读实例连接地址修改为主实例连接地址，并删除现有的只读实例。升级完成后，请重新购买并配置新的只读实例。