Atualizar cluster no Azure Cosmos DB for PostgreSQL

Importante

O Azure Cosmos DB para PostgreSQL não tem mais suporte para novos projetos. Não use esse serviço para novos projetos. Em vez disso, use um destes dois serviços:

• Use o Azure Cosmos DB para NoSQL para uma solução de banco de dados distribuída projetada para cenários de alta escala com um SLA (contrato de nível de serviço de disponibilidade) de 99,999%, dimensionamento automático instantâneo e failover automático em várias regiões.

• Use o Recurso Clusters Elásticos do Banco de Dados do Azure para PostgreSQL no PostgreSQL compartilhado usando a extensão de código aberto Citus.

Estas instruções descrevem como atualizar para uma nova versão principal do PostgreSQL em todos os nós do cluster.

Testar a atualização primeiro

Atualizar o PostgreSQL causa mais mudanças do que você imagina, pois o Azure Cosmos DB for PostgreSQL também atualizará as extensões de banco de dados, incluindo a extensão Citus. As atualizações também exigem tempo de inatividade no cluster de banco de dados.

É altamente recomendável que você teste seu aplicativo com a nova versão do PostgreSQL e do Citus antes de atualizar o ambiente de produção. Além disso, confira nossa lista de precauções de atualização.

Uma forma prática de testar é fazer uma cópia do cluster usando a restauração pontual. Atualize a cópia e teste seu aplicativo em relação a ela. Depois de verificar que tudo funciona corretamente, atualize o cluster original.

Atualizar um cluster no portal do Azure

1. Na seção de Visão geral de um cluster, selecione o botão Atualizar.
2. Uma caixa de diálogo é exibida, mostrando a versão atual do PostgreSQL e do Citus. Escolha uma nova versão do PostgreSQL na lista Versão do PostgreSQL para atualizar.
3. Verifique se o valor em Versão do Citus após a atualização é o que você espera. Esse valor é alterado com base na versão do PostgreSQL que você seleciona.
4. Selecione o botão Atualizar para continuar.

Observação

Se você já estiver executando a versão mais recente do PostgreSQL, a seleção e o botão ficarão esmaecidos.

Tarefas de pós-atualização

Após um upgrade para uma versão principal do PostgreSQL, execute a operação ANALYZE para atualizar a tabela pg_statistic. pg_statistic é uma tabela de catálogo do sistema no PostgreSQL que armazena dados estatísticos sobre o conteúdo de colunas de tabela e expressões de índice. As entradas de dados em pg_statistic são criadas pelo comando ANALYZE e usadas pelo planejador de consultas.

Execute o comando ANALYZE sem nenhum parâmetro para gerar estatísticas para as tabelas no banco de dados do seu cluster. O nome do banco de dados padrão é "citus". Se o nome do banco de dados personalizado tiver sido usado no momento da criação do cluster, você poderá encontrá-lo na página Visão Geral das propriedades do seu cluster. Usar o sinalizador opcional VERBOSE permite que você acompanhe o progresso.

ANALYZE VERBOSE;

Observação

O desempenho do banco de dados poderá ser afetado se você não executar a operação ANALYZE após o upgrade para uma versão principal do PostgreSQL no seu cluster.

Próximas etapas

• Saiba mais sobre Versões compatíveis do PostgreSQL.
• Veja quais extensões são empacotadas com cada versão do PostgreSQL em um cluster.
• Saiba mais sobre atualizações