Compartilhar via


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:

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