Todos os produtos
Search

Este produto

    ApsaraDB RDS:Upgrade the minor engine version of an ApsaraDB RDS for PostgreSQL instance

    Central de documentação

    ApsaraDB RDS:Upgrade the minor engine version of an ApsaraDB RDS for PostgreSQL instance

    Última atualização: Oct 10, 2026

    O ApsaraDB RDS for PostgreSQL permite atualizar a versão secundária do mecanismo. Essas atualizações oferecem melhorias de desempenho, novos recursos e correções de segurança para otimizar e proteger continuamente seu service de banco de dados.

    Para obter mais informações sobre os recursos das versões secundárias do mecanismo do ApsaraDB RDS for PostgreSQL, consulte AliPG kernel minor version releases (PostgreSQL 14 to 18).

    Observações de uso

    • A atualização da versão secundária do mecanismo reinicia a instância, causando uma interrupção de conexão de aproximadamente 30 segundos. Recomendamos executar a atualização fora dos horários de pico ou garantir que sua aplicação possua um mecanismo de reconexão automática.

    • Não é possível fazer downgrade da versão secundária do mecanismo após uma atualização.

    • Atualizações de versão secundária do mecanismo geralmente não causam problemas de compatibilidade. No entanto, atualizações de extensões podem causar. Se a atualização envolver uma extensão, como a GanosBase, recomendamos usar o recurso Restore PostgreSQL data para criar uma instância de teste e verificar a compatibilidade da nova extensão.

    • Considere os pontos a seguir para atualizações de extensões:

      • Caso sua instância utilize a extensão PostGIS ou GanosBase, atualize manualmente também a extensão PostGIS ou GanosBase após atualizar a versão secundária do mecanismo. Para mais informações, consulte Upgrade spatiotemporal engine extensions.

      • Se sua instância executa o PostgreSQL 14 com uma versão secundária do mecanismo anterior a 20230330 e você usa a extensão TimescaleDB (versão 2.5.0 ou anterior), atualize a extensão após atualizar a versão secundária do mecanismo para 20230330 ou posterior. Para isso, execute manualmente o comando ALTER EXTENSION timescaledb UPDATE;. Essa etapa é necessária para continuar usando a extensão TimescaleDB.

    Visualizar a versão secundária do mecanismo

    Visualize a versão secundária atual do mecanismo de uma instância das seguintes formas:

    • Faça login no console do ApsaraDB RDS. A versão está disponível na página Basic Information da sua instância.

      Nota

      Este método aplica-se apenas a instâncias de disco em nuvem do ApsaraDB RDS for PostgreSQL.

    • Conecte-se à target PostgreSQL instance e execute o comando show rds_release_date;.

      Nota

      Este método aplica-se a instâncias de disco em nuvem e de disco local do ApsaraDB RDS for PostgreSQL.

    Atualizar manualmente a versão secundária do mecanismo

    Atualizar instâncias de disco local

    Não é possível atualizar manualmente uma instância de disco local. Para atualizar, reinicie a instância para que ela seja atualizada automaticamente para a versão secundária mais recente do mecanismo. Para mais informações, consulte Restart an ApsaraDB RDS for PostgreSQL instance.

    Nota

    Para instâncias primárias com instâncias somente leitura anexadas, reinicie primeiro cada instância somente leitura e, em seguida, a instância primária. Reiniciar apenas a instância primária não atualiza as versões secundárias do mecanismo das instâncias somente leitura anexadas.

    Atualizar instâncias de disco em nuvem

    Nota

    Para uma instância primária com instâncias somente leitura anexadas, use um dos seguintes métodos de atualização:

    • Inicie a atualização na instância primária. Essa ação atualiza primeiro todas as instâncias somente leitura anexadas simultaneamente e, em seguida, atualiza a instância primária.

    • Para evitar uma atualização simultânea de todas as instâncias somente leitura, atualize cada uma individualmente antes de atualizar a instância primária.

    1. Acesse a página Instances. Na barra de navegação superior, selecione a região onde a instância RDS reside. Em seguida, localize a instância RDS e clique em ID da instância.

    2. Na seção Configuration Information, clique em Update Minor Engine Version.

    3. Na caixa de diálogo exibida, selecione uma versão na lista suspensa Latest Version, especifique o Update Time e clique em OK.

      A string Latest Version consiste nas seguintes partes:

      • rds: A instância é uma instância RDS.

      • postgres: O mecanismo de banco de dados é o PostgreSQL.

      • 1200: A versão principal do PostgreSQL é a 12.

      • 20220830: A versão secundária do mecanismo do kernel AliPG. Para mais informações sobre cada versão secundária do mecanismo, consulte AliPG kernel minor version releases (PostgreSQL 14 to 18).

      • 12.11: A versão secundária da comunidade PostgreSQL.

    Atualizar automaticamente a versão secundária do mecanismo

    Aviso

    As atualizações automáticas são um método complementar e não garantem que todas as instâncias sejam atualizadas imediatamente para a versão secundária mais recente do mecanismo. Visualize o status da versão secundária do mecanismo na página Basic Information da sua instância e atualize proativamente a versão secundária do mecanismo para mitigar riscos potenciais associados a versões desatualizadas. Se você cancelar uma tarefa de atualização iniciada pelo sistema ou não conseguir atualizar para a versão estável mais recente após receber uma notificação no console, será responsável por quaisquer interrupções de negócios ou perda de dados resultantes. Para mais informações, consulte os Termos de Serviço.

    Ao adquirir uma instância do ApsaraDB RDS for PostgreSQL com discos em nuvem, a Minor Engine Version Update Policy é definida como Automatic Upgrade por padrão. Se sua versão secundária do mecanismo for anterior à versão mais recente, o sistema agenda periodicamente tarefas proativas de O&M para atualizar a versão secundária do mecanismo. Você recebe notificações sobre essas tarefas por e-mail e mensagens internas. A atualização automática é executada dentro da janela de manutenção configurada por você. É possível alterar o horário da atualização em Event Management ou cancelar uma tarefa antes que ela comece. Para mais informações, consulte Scheduled events.

    Nota

    O recurso de atualização automática da versão secundária do mecanismo está disponível apenas para instâncias de disco em nuvem.

    Modificar configurações de atualização automática

    1. Acesse a página Instances. Na barra de navegação superior, selecione a região onde a instância RDS reside. Em seguida, localize a instância RDS e clique em ID da instância.

    2. Na página Basic Information, vá até a seção Configuration Information e visualize o status de Automated Update of Minor Engine Version.

    3. Clique em Settings à direita de Automated Update of Minor Engine Version.

    4. Na caixa de diálogo exibida, selecione Automatic Upgrade ou Manual Upgrade e clique em OK.

    Perguntas frequentes

    O que devo fazer se o acesso à extensão PostGIS ou GanosBase falhar após uma atualização da versão secundária do mecanismo?

    Após atualizar a versão secundária do mecanismo, atualize manualmente também a extensão PostGIS ou GanosBase. Para mais informações, consulte Upgrade spatiotemporal engine extensions.

    Quais problemas de compatibilidade do PostGIS podem ocorrer durante uma atualização da versão secundária do mecanismo?

    A tabela a seguir descreve as diferenças de compatibilidade.

    Nota

    Os seguintes problemas de compatibilidade podem ocorrer em instâncias do ApsaraDB RDS for PostgreSQL que executam uma versão secundária do mecanismo anterior a 20211031.

    Versão da extensão PostGIS

    Apenas atualização do mecanismo

    Atualização do mecanismo e da extensão

    2.5.x

    • As seguintes funções podem causar falha no banco de dados:

      • ST_ClusterKMeans

      • ST_GeomFromKML

      • ST_AsKML

    • As seguintes funções relatam um erro:

      • ST_Buffer

        Mensagem de erro: Invalid buffer parameter: uad_segs (accept: 'endcap', 'join', 'mitre_limit', 'miter_limit', 'quad_segs' and 'side')

        Solução: Altere o parâmetro quadsegs para quad_segs.

      • ST_Intersects

        Mensagem de erro: ERROR: GetGenericCacheCollection: Could not find upper context

        Solução: Nenhuma.

    • As seguintes funções foram removidas e não podem mais ser usadas:

      • ST_Force_2D

      • ST_Locate_Along_Measure

      • ST_Estimated_Extent

    • Os valores de parâmetro ou a sintaxe das seguintes funções mudam após a atualização:

      • ST_GeomFromGeoJSON: Após a atualização, SRID=4326 é especificado por padrão.

      • ST_AsGeoJSON: O parâmetro maxdecimaldigits foi alterado de 16 para 9.

      • A sintaxe para MultiPoint muda:

        • Antes da atualização: MULTIPOINT(1 1,-1 1)

        • Após a atualização: MULTIPOINT((1 1),(-1 1))

    • As seguintes funções foram removidas e não podem mais ser usadas:

      • ST_Force_2D

      • ST_Locate_Along_Measure

      • ST_Estimated_Extent

    • Os valores de parâmetro ou a sintaxe das seguintes funções mudam após a atualização:

      • ST_GeomFromGeoJSON: Após a atualização, SRID=4326 é especificado por padrão.

      • ST_AsGeoJSON: O parâmetro maxdecimaldigits foi alterado de 16 para 9.

      • A sintaxe para MultiPoint muda:

        • Antes da atualização: MULTIPOINT(1 1,-1 1)

        • Após a atualização: MULTIPOINT((1 1),(-1 1))

    3.1.x

    • A seguinte função pode causar falha no banco de dados:

      • ST_ClusterKMeans

    • A sintaxe para MultiPoint muda:

      • Antes da atualização: MULTIPOINT(1 1,-1 1)

      • Após a atualização: MULTIPOINT((1 1),(-1 1))

    A sintaxe para MultiPoint muda:

    • Antes da atualização: MULTIPOINT(1 1,-1 1)

    • Após a atualização: MULTIPOINT((1 1),(-1 1))

    Documentos relacionados