Extensões e objetos de replicação lógica a serem analisados

Verifique os seguintes itens antes da atualização:

pg_repack

Exclua a pasta pg_repack antes da atualização e recrie-a após a atualização. O pg_repack utiliza uma extensão específica da versão e componentes cliente/servidor que devem corresponder à versão principal do PostgreSQL.

DROP EXTENSION pg_repack;

Recrie a extensão após a atualização apenas se sua carga de trabalho ainda precisar dela.

CREATE EXTENSION pg_repack;

old_snapshot

Exclua o arquivo old_snapshot antes da atualização. PostgreSQL NÃO o recrie após atualizar para o Windows 18, pois ele não é mais compatível.

DROP EXTENSION old_snapshot;

wal2json slots de replicação

Se você usar o wal2json para a decodificação lógica, é necessário excluir todos os slots de replicação associados antes da atualização. O utilitário pg_upgrade proíbe estritamente atualizações de versão principal enquanto houver slots de replicação e, nesse caso, gerará um erro crítico e interromperá a atualização.

Antes da atualização:

1. Certifique-se de que todos os dados WAL pendentes tenham sido processados.
2. Encerre o aplicativo que está utilizando o slot de replicação.
3. Excluir os slots de replicação:

SELECT pg_drop_replication_slot('your_slot_name');

Após a atualização, você poderá recriar os slots de replicação conforme necessário. Observe que o wal2json não é instalado por meio do CREATE EXTENSION , mas é configurado por meio de parâmetros de banco de dados (wal_level, max_replication_slots, max_wal_senders) e permissões de tabela, o que não impede a realização de atualizações.

anon

Desative a extensão " anon " antes da atualização e reative-a após a atualização, caso ainda precise dela. É necessário realizar algumas etapas adicionais antes de desinstalar o anon.

Se a extensão anon estiver instalada, siga as etapas abaixo e execute os comandos como usuário administrador antes de realizar a atualização.

1. Remover todas as regras de mascaramento (se ativadas).

   SELECT anon.remove_masks_for_all_columns();
   

2. Desative as funções de mascaramento (a atualização poderá falhar se alguma função estiver marcada como mascarada).

   SECURITY LABEL FOR anon ON ROLE <role_name> IS NULL;
   

3. Elimine a extensão anon com a opção em cascata.

   DROP EXTENSION anon CASCADE;
   

4. Se a extensão anon estiver instalada em vários bancos de dados dentro de uma instância, execute as etapas descritas para cada banco de dados.

5. Após a conclusão da atualização, reative a extensão anon e reaplique as regras de mascaramento conforme necessário.

É altamente recomendável validar os dados antes e depois de eliminar a extensão para garantir a consistência do mascaramento antes de realizar a atualização.

PostGIS

Se você estiver usando o PostGIS,, atualize primeiro o PostGIS antes de atualizar o PostgreSQL.

SELECT postgis_extensions_upgrade();

Use a consulta a seguir para validar a atualização da extensão PostGIS.

SELECT postgis_full_version();

Logical replication slots

Elimine todos os slots de replicação lógica antes da atualização e recrie-os após a atualização. Os slots lógicos estão vinculados ao estado do servidor de origem e devem ser recriados do zero na instância atualizada.

SELECT pg_drop_replication_slot('<slot_name>');

Antes de Iniciar

Considere os seguintes aspectos antes de iniciar o procedimento de atualização.

• Verifique se há uma atualização de versão disponível para a sua versão de implantação, consultando as informações sobre a capacidade de implantação por meio da interface do usuário, da API, da CLI ou do Terraform.

  Exemplo: consultar informações sobre atualizações de versão usando a CLI:

  ibmcloud cdb capability-show versions postgresql
  

• Certifique-se de revisar os requisitos relacionados à pré-verificação neste tópico antes de acionar o IPU. O IPU é executado diretamente na implantação de origem e não cria uma nova instância. Para garantir a segurança do cliente, o serviço realiza verificações prévias antes do início da atualização e bloqueia a operação caso seja detectado algum risco. Em particular, verifique os seguintes itens:

  • Sua implantação tem, no máximo, 3 membros.
  • Sua implantação está em bom estado.
  • Sua implantação tem pelo menos 10% de espaço livre em disco disponível. O limite máximo padrão de uso de disco permitido para as verificações prévias da IPU é de 90%.
  • Sua implantação não está sob forte pressão de E/S. A utilização máxima permitida por padrão de E/S para a pré-verificação da IPU é de 90%.
  • O tamanho do seu esquema e o número de objetos estão dentro dos limites padrão de pré-verificação. Por padrão, nenhum esquema individual pode exceder 100 GB, e o número total de índices e sequências deve permanecer abaixo de 50.000.
  • Você concluiu todas as tarefas necessárias de limpeza das extensões e dos slots de replicação lógica antes da atualização.

• Cada versão principal contém alguns recursos que podem não ser compatíveis com versões anteriores. Verifique as notas de lançamento do fornecedor do banco de dados para identificar quaisquer alterações que possam afetar suas aplicações.

• O downgrade de uma implantação para uma versão anterior não é suportado.

• A atualização de versão principal no local não pode ser cancelada após o início.

• Se você não tiver um backup recente, considere fazer um antes de atualizar.

Além disso, observe que, após a conclusão da atualização, seu banco de dados passará a utilizar uma nova versão principal do PostgreSQL. Como o PostgreSQL armazena dados em formatos específicos de cada versão, os backups e pontos de PITR anteriores à atualização pertencem à linha do tempo da versão anterior e não podem ser restaurados na versão atualizada. Para manter os recursos de restauração completa e PITR (Recuperação em um Momento Específico) na nova versão, faça um novo backup imediatamente após a conclusão da atualização. Esse backup passa a ser a base para futuras operações de recuperação na linha do tempo da nova versão.

Se o IPU falhar, os backups válidos anteriores à atualização ainda poderão ser usados com o PITR para restaurar a versão anterior do PostgreSQL em uma nova instância.

Resolução de problemas

Se seus aplicativos apresentarem problemas inesperados após uma atualização bem-sucedida da versão principal no local e você precisar retornar à versão PostgreSQL anterior, entre em contato com nossa equipe de suporte para obter orientação. Evite iniciar um PITR ou restaurar um backup por conta própria, pois isso pode complicar a recuperação.

Uma atualização importante no local não será realizada até que todas as verificações prévias tenham sido aprovadas. Essas medidas de segurança existem para proteger sua implantação, pois a atualização é realizada diretamente na instância de origem. Se a atualização estiver bloqueada, verifique as seguintes áreas:

• Número de membros: a atualização de versão principal sem interrupção suporta implantações com, no máximo, 3 membros. Se sua implantação tiver mais de 3 membros, as verificações prévias bloqueiam a atualização. Os membros não podem ser removidos por meio do dimensionamento horizontal; portanto, abra um ticket de suporte no endereço IBM Cloud para reduzir o número de membros antes de tentar novamente a atualização.
• Estado do cluster: certifique-se de que o cluster do Patroni esteja em bom estado e que haja um estado claro de líder/réplica. As atualizações não podem prosseguir se o Patroni relatar instabilidade ou condições de failover.
• Espaço em disco: verifique se há espaço livre suficiente disponível. O processo utiliza o modo pg_upgrade de ligação, que requer espaço livre adequado. Se o uso do disco exceder o limite configurado (padrão: 90%), libere espaço antes de tentar novamente.
• Carga de E/S do disco: verifique a utilização atual de E/S e o número de IOPS. As atualizações são pausadas quando o sistema está sob carga pesada para evitar a degradação do desempenho ou falha na atualização.
• Tamanho do esquema e contagem de objetos: conforme mencionado, o tamanho do esquema afeta diretamente a duração de uma atualização de versão principal no local. Certifique-se de que nenhum esquema individual exceda o tamanho máximo (padrão: 100 GB) e que o número total de objetos de índice e sequência permaneça abaixo do limite (padrão: 50.000). Esquemas grandes ou contagens de objetos excepcionalmente altas podem exigir limpeza ou otimização antes de prosseguir com a atualização. pg_upgrade realiza atualizações rápidas criando novas tabelas do sistema e simplesmente reutilizando os arquivos de dados antigos do usuário. O tempo necessário para criar essas tabelas do sistema varia de acordo com o número de objetos do banco de dados. O consumo de recursos pode ser avaliado usando a integração de monitoramento. Se nem todos os componentes do banco de dados estiverem disponíveis para atualização, a tarefa de atualização falhará. Isso pode ocorrer devido à manutenção. As tarefas que falharam devido a verificações de integridade com falha podem ser repetidas mais tarde. Se a tarefa continuar falhando, abra um ticket de suporte com IBM Cloud o suporte. Se determinadas verificações não forem relevantes para o seu ambiente e a atualização ainda estiver bloqueada, crie um ticket de suporte para obter mais assistência.

Simulando a promoção e o upgrade

Para avaliar os efeitos das atualizações de versão principais, execute um teste simulado. Uma simulação simula a promoção e o upgrade, com os resultados impressos nos logs do banco de dados. Acesse e visualize os registros do seu banco de dados por meio da integração de análise de registro. Isso garante que a versão que você está executando no momento, juntamente com suas extensões, possa ser atualizada com sucesso para a versão desejada.

A simulação deve ser executada com skip_initial_backup configurado como false e version definida.

O comando é semelhante a:

curl -X POST \
  https://api.{region}.databases.cloud.ibm.com/v5/ibm/deployments/{id}/remotes/promotion \
  -H 'Authorization: Bearer <>'  \
 -H 'Content-Type: application/json' \
 -d '{
    "promotion": {
        "version": "14",
        "skip_initial_backup": false,
        "dry_run": true
    }
}' \