ApsaraDB RDS:Upgrade spatio-temporal engine plug-ins

Consultar plug-ins GanosBase instalados

1. Conecte-se ao banco de dados com uma ferramenta de linha de comando do PostgreSQL.

2. Execute a instrução SQL a seguir para consultar os plug-ins GanosBase instalados.

   SELECT
     *,
     installed_version < default_version AS need_update
   FROM
     pg_available_extensions
   WHERE
     name LIKE 'ganos%';

   Exemplo de saída:

                   name           | default_version | installed_version |                                                       comment                        | need_update
   -------------------------------+-----------------+-------------------+--------------------------------------------------------------------------------------+-------------
    ganos_trajectory              | 5.5             | 5.4               | Ganos trajectory extension for PostgreSQL                                            | t
    ganos_pointcloud_geometry     | 5.5             | 5.4               | Ganos_pointcloud LIDAR data and ganos_geometry data for PostgreSQL                   | t
    ganos_raster                  | 5.5             | 5.4               | Ganos raster extension for PostgreSQL                                                | t
    ganos_networking              | 5.5             | 5.4               | Ganos networking extension for PostgreSQL                                            | t
    ganos_geometry_pyramid        | 5.5             | 5.4               | Ganos Geometry Pyramid extension for PostgreSQL                                      | t
    ganos_scene                   | 5.5             | 5.4               | Ganos scene extension for PostgreSQL                                                 | t
    ganos_geometry_topology       | 5.5             | 5.4               | Ganos geometry topology spatial types and functions extension for PostgreSQL         | t
    ganos_tiger_geocoder          | 5.5             | 5.4               | Ganos tiger geocoder and reverse geocoder                                            | t
    ganos_importer                | 5.5             | 5.4               | Ganos Spatial importer extension for PostgreSQL                                      | t
    ganos_vomesh                  | 5.5             | 5.4               | Ganos volumn mesh extension for PostgreSQL                                           | t
   ...

   Parâmetro	Descrição
   name	Nome do plug-in.
   default_version	Versão mais recente disponível para instalação no banco de dados atual.
   installed_version	Versão atualmente instalada.
   comment	Descrição do plug-in.
   need_update	Indica se é necessária uma atualização.

   Nota

   No resultado da consulta, o valor t na coluna need_update indica que uma atualização é necessária.

Atualizar plug-ins GanosBase

• Se a versão do seu plug-in GanosBase for 3,1 ou superior, execute a instrução abaixo para atualizar todos os plug-ins GanosBase.

  SELECT ganos_update();

• Se a versão do plug-in GanosBase for anterior à 3,1, crie uma função para atualizar todos os plug-ins GanosBase. Execute a seguinte instrução:

  CREATE OR REPLACE FUNCTION ganos_update()
      RETURNS text AS
  $$
  DECLARE
      rec RECORD;
      sql text;
  BEGIN
      FOR rec IN
          SELECT extname
          FROM pg_extension
          WHERE extname like 'ganos_%'
          LOOP
              sql = 'ALTER EXTENSION '
                  || rec.extname
                  || ' UPDATE ';
              RAISE NOTICE '%', sql;
              EXECUTE sql;
          END LOOP;
      return 'All Ganos extensions have been updated to the latest version';
  END
  $$ LANGUAGE 'plpgsql' volatile STRICT;

Etapa 1: Consultar plug-ins PostGIS instalados

1. Conecte-se ao banco de dados com uma ferramenta de linha de comando do PostgreSQL.

2. Execute a instrução SQL a seguir para consultar os plug-ins PostGIS instalados.

   SELECT
     *,
     installed_version < default_version AS need_update
   FROM
     pg_available_extensions
   WHERE
     name LIKE 'postgis%';

   Exemplo de saída:

             name          | default_version | installed_version |              comment               | need_update 
   ------------------------+-----------------+-------------------+------------------------------------+-------------
    postgis                | 3.3.2           | 3.1.4             | Ganos PostGIS+                     | t
    postgis_tiger_geocoder | 3.3.2           | 3.1.4             | Ganos PostGIS+ tiger geocoder      | t
    postgis_raster         | 3.3.2           | 3.1.4             | PostGIS raster types and functions | t
    ...

   Parâmetro	Descrição
   name	Nome do plug-in.
   default_version	Versão mais recente disponível para instalação no banco de dados atual.
   installed_version	Versão atualmente instalada.
   comment	Descrição do plug-in.
   need_update	Indica se é necessária uma atualização.

   Nota

   No resultado da consulta, o valor t na coluna need_update indica que uma atualização é necessária.

Etapa 2: Atualizar plug-ins PostGIS

O método de atualização dos plug-ins PostGIS varia conforme a versão principal da sua instância RDS PostgreSQL.

• Para as versões principais 10, 13, 14 ou 15 do RDS PostgreSQL, proceda com a atualização da seguinte forma:

  Execute a instrução SQL abaixo para atualizar o plug-in PostGIS.

  ALTER EXTENSION <plug-in_name> UPDATE;

  Nota

  • Execute essa instrução individualmente para cada plug-in.

  • Como alternativa, use a função PostGIS_Extensions_Upgrade para atualizar os plug-ins. Para mais informações, consulte PostGIS_Extensions_Upgrade.

  SELECT PostGIS_Extensions_Upgrade();

• Para as versões principais 11 e 12 do RDS PostgreSQL, siga este procedimento de atualização:

  Execute a instrução SQL a seguir para atualizar o plug-in PostGIS.

  do
  $$
  DECLARE
      with_pgis boolean;
      with_ganos boolean;
  BEGIN
      SELECT ((SELECT 1 FROM pg_extension WHERE extname='postgis') IS NOT null)
      INTO with_pgis;
  
      SELECT ((SELECT 1 FROM pg_extension WHERE extname='ganos_geometry') IS NOT null)
      INTO with_ganos;
  
      IF with_pgis AND with_ganos THEN
          PERFORM ganos_update();
      ELSIF with_ganos THEN
          PERFORM ganos_update();
      ELSIF with_pgis THEN
          PERFORM PostGIS_Extensions_Upgrade();
      END IF;
  
      return 'PostGIS has been updated to ' || postgis_lib_version();
  END
  $$ LANGUAGE 'plpgsql' ;

  Importante

  Em algumas instâncias RDS PostgreSQL 11 e 12, o plug-in PostGIS é implementado por meio do Ganos. Se ocorrer um erro semelhante a ERROR: RETURN cannot have a parameter in function returning void durante a execução desta instrução SQL, execute o comando SELECT postgis_lib_version(); para verificar se a atualização do plug-in PostGIS foi concluída com êxito.