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;