ApsaraDB RDS：通過本地升級模式升級大版本

大版本升級期間不支援變更執行個體，必須在大版本升級完成後才能進行其他動作。

暫不支援自動升級資料庫大版本。

升級後暫不支援進行大版本降級操作，如需降級，請購買低版本執行個體後，使用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;

升級完成後，自建的唯讀節點和複製槽在升級後仍然保留在原執行個體下，不會自動轉移到高版本執行個體。因此，在進行大版本升級前，請將應用程式中配置的唯讀執行個體串連地址修改為主執行個體串連地址，並刪除現有的唯讀執行個體。升級完成後，請重新購買並配置新的唯讀執行個體。