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: Jun 26, 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 serviço 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 Lançamentos de versões secundárias do kernel AliPG (PostgreSQL 14 a 18).

    Observações de uso

    • A atualização da versão secundária do mecanismo reinicia a instância e causa uma interrupção de conexão de aproximadamente 30 segundos. Recomendamos realizar 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 Restaurar dados do PostgreSQL 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:

      • Se sua instância utilizar 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 Atualizar extensões do mecanismo espaço-temporal.

      • Caso sua instância execute o PostgreSQL 14 com uma versão secundária do mecanismo anterior a 20230330 e utilize a extensão TimescaleDB (versão 2.5.0 ou anterior), atualize a extensão após elevar a versão secundária do mecanismo para 20230330 ou posterior. Para isso, execute manualmente o comando ALTER EXTENSION timescaledb UPDATE;. Essa etapa é indispensável 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 à instância PostgreSQL de destino 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 automaticamente elevada à versão secundária mais recente do mecanismo. Para mais informações, consulte Reiniciar uma instância do ApsaraDB RDS for PostgreSQL.

    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, utilize 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, depois, a instância primária.

    • Para evitar a 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 está localizada. Em seguida, localize a instância RDS e clique em Update Minor Engine Version.

    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 é composta pelas 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 detalhes sobre cada versão secundária do mecanismo, consulte Lançamentos de versões secundárias do kernel AliPG (PostgreSQL 14 a 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 imediatamente elevadas à versão secundária mais recente do mecanismo. Verifique 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 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 atualizá-la. Você recebe notificações sobre essas tarefas por e-mail e mensagens internas. A atualização automática ocorre dentro da janela de manutenção configurada. Altere o horário da atualização em Event Management ou cancele uma tarefa antes que ela comece. Para mais informações, consulte Eventos agendados.

    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 está localizada. Em seguida, localize a instância RDS e clique em Settings.

    2. Na página Basic Information, vá até a seção Configuration Information e verifique o status da 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 Atualizar extensões do mecanismo espaço-temporal.

    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 executando 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 funções a seguir podem causar falha no banco de dados:

      • ST_ClusterKMeans

      • ST_GeomFromKML

      • ST_AsKML

    • As funções a seguir reportam 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 funções a seguir foram removidas e não podem mais ser usadas:

      • ST_Force_2D

      • ST_Locate_Along_Measure

      • ST_Estimated_Extent

    • Os valores de parâmetros ou a sintaxe das funções a seguir 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 funções a seguir foram removidas e não podem mais ser usadas:

      • ST_Force_2D

      • ST_Locate_Along_Measure

      • ST_Estimated_Extent

    • Os valores de parâmetros ou a sintaxe das funções a seguir 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 função a seguir 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