ApsaraDB for MongoDB:Atualizar a versão principal do banco de dados

Precauções

• Requisito de protocolo: Para atualizar a versão principal de uma instância de cluster sharded, a instância deve usar o MongoDB Protocol.

• Espaço em disco: Antes de atualizar a versão principal do banco de dados, recomenda-se que o uso de disco da instância não ultrapasse 90%. A atualização grava arquivos temporários. Se o espaço disponível em disco for insuficiente (menos de 20% da capacidade total), a atualização pode falhar ou causar falhas na instância. Caso o espaço disponível não atenda ao requisito, aumente o disco primeiro. Inicie a atualização somente após o espaço disponível atingir pelo menos 20% da capacidade total do disco.

• Processo de atualização e impacto:

  • Reinicializações automáticas: A atualização é um processo contínuo que reinicia a instância automaticamente de duas a três vezes. Recomendamos realizar a atualização fora dos horários de pico e garantir que sua aplicação possua um mecanismo de reconexão.

  • Impacto no desempenho: A partir do MongoDB 5.0, o writeConcern padrão muda de {w:1} para {w:majority}. Se você atualizar a versão principal da instância de 4.4 para 5.0, poderá notar uma degradação significativa no desempenho de escrita.

    Nota

    • Para atualizações entre múltiplas versões, como da v3.0 para a v4.2, o sistema executa a atualização sequencialmente por cada versão intermediária. Uma desconexão transitória ocorre após a atualização de cada versão.

    • Recomendamos que aplicações em ambiente de produção se conectem ao banco de dados usando um Connection String URI.

      O uso de um Connection String URI para conectar-se a uma instância garante que o nó conectado seja sempre o primário. Isso evita que as operações de leitura e escrita da sua aplicação sejam afetadas por um failover. Para mais informações sobre como se conectar a um banco de dados usando um Connection String URI, consulte Connect to a replica set instance ou Connect to a sharded cluster instance.

• Status do Balancer: Durante a atualização de uma instância de cluster sharded, o balancer é desativado e reativado após a conclusão da atualização.

• Downgrade de versão: Você não pode fazer downgrade da versão principal após uma atualização.

• Backup e restauração: Após atualizar a versão principal de um banco de dados, não é possível restaurar dados na instância do ApsaraDB for MongoDB a partir de um backup de uma versão principal anterior. Baixe o arquivo de backup e restaure os dados em um banco de dados autogerenciado. Para mais informações sobre como restaurar dados de backup em um banco de dados autogerenciado, consulte Restore data from a cloud disk backup ou Restore data from a local disk backup.

• Duração da atualização: O tempo de duração depende de fatores como volume de dados, quantidade de bancos de dados e tabelas, e a diferença entre versões. As estimativas abaixo servem apenas como referência, pois os tempos reais podem variar.

  • Instâncias com discos cloud: aproximadamente 15 minutos.

  • Instâncias com discos locais: para atualizações para uma versão adjacente, o processo leva vários minutos, semelhante a uma reinicialização de instância.

  • Uma atualização para versão adjacente, como do MongoDB 3.4 para o MongoDB 4.0, geralmente leva de 1 a 5 minutos. O processo aciona de duas a três reinicializações, e cada uma causa uma desconexão transitória de cerca de 30 segundos. A duração não está relacionada ao uso do disco. Realize a atualização fora dos horários de pico e garanta que a aplicação tenha um mecanismo de reconexão.

Caminhos de atualização compatíveis

• É possível atualizar a versão principal de um banco de dados no console do ApsaraDB for MongoDB. No entanto, as versões de destino disponíveis variam conforme a arquitetura da instância, o tipo de instância e a versão atual. Os detalhes são os seguintes:

  Arquitetura	Tipo de instância	Versão principal atual	Versões de atualização disponíveis
  Arquitetura Standalone	Uso geral com disco cloud	MongoDB 4.0	Nenhuma versão principal superior está disponível para atualização.
  	Uso geral com disco cloud	MongoDB 3.4	Compatível com atualização para MongoDB 4.0.
  Arquitetura Replica set	Uso geral com disco cloud Dedicado com disco cloud	MongoDB 8.0	MongoDB 8.3
  		MongoDB 7.0	MongoDB 8.0
  		MongoDB 6.0	MongoDB 7.0
  		MongoDB 5.0	MongoDB 6.0
  		MongoDB 4.4	MongoDB 5.0 Ao atualizar uma instância da v4.4 para a v5.0, o writeConcern padrão muda de {w:1} para {w:majority}. Isso pode reduzir o desempenho de escrita e aumentar a latência de escrita. Confirme se esse impacto é aceitável antes de prosseguir com a atualização.
  	Uso geral com disco local Dedicado com disco local Servidor Físico Dedicado	MongoDB 4.2	Atualização in-place não compatível. Para atualizar a versão principal, crie uma nova instância e use-a para substituir a instância original.
  		MongoDB 4.0	MongoDB 4.2
  		MongoDB 3.4	MongoDB 4.0 MongoDB 4.2
  		MongoDB 3.2
  		MongoDB 3.0
  Arquitetura Sharded cluster	Dedicado com disco cloud	MongoDB 8.0	MongoDB 8.3 (Envie um ticket para solicitar)
  		MongoDB 7.0	MongoDB 8.0
  		MongoDB 6.0	MongoDB 7.0
  		MongoDB 5.0	MongoDB 6.0
  		MongoDB 4.4	MongoDB 5.0 Ao atualizar uma instância da v4.4 para a v5.0, o writeConcern padrão muda de {w:1} para {w:majority}. Isso pode reduzir o desempenho de escrita e aumentar a latência de escrita. Confirme se esse impacto é aceitável antes de prosseguir com a atualização.
  	Uso geral com disco local Dedicado com disco local Servidor Físico Dedicado	MongoDB 4.2	Atualização in-place não compatível. Para atualizar a versão principal, crie uma nova instância e use-a para substituir a instância original.
  		MongoDB 4.0	MongoDB 4.2
  		MongoDB 3.4	MongoDB 4.0 MongoDB 4.2
  		MongoDB 3.2
  		MongoDB 3.0

• Caso precise atualizar a versão principal entre diferentes arquiteturas ou tipos de armazenamento, primeiro crie uma instância com a versão principal de destino e depois use o Data Transmission Service (DTS) para migrar os dados da source para a nova instância.

  Consulte os tópicos a seguir para instruções de migração de dados:

  • Migrate data from an ApsaraDB for MongoDB standalone instance to an ApsaraDB for MongoDB instance of any architecture

  • Migrate data from an ApsaraDB for MongoDB replica set instance to an ApsaraDB for MongoDB replica set or sharded cluster instance

  • Migrate data from a self-managed MongoDB sharded cluster database to an ApsaraDB for MongoDB replica set or sharded cluster instance

Testes de compatibilidade

Antes de atualizar a versão principal, realize um teste de compatibilidade.

• Um teste de atualização de versão principal do banco de dados não é afetado pelo fato de as instâncias usarem uma única zona ou serem multizona. A instância de teste precisa apenas ter a mesma região, VPC e especificações de instância que a instância a ser atualizada.

• Verifique a compatibilidade do driver do cliente antes da atualização. Por exemplo, ao atualizar do MongoDB 3.4 para o MongoDB 4.0 usando uma configuração de conexão Spring XML, recomendamos atualizar o driver para 4.11.2. É possível manter as configurações existentes de replica-set, socket-timeout e outros parâmetros. Se ainda estiver usando um driver anterior, como o 3.3, atualize para 3.6 ou posterior para garantir suporte completo aos novos recursos.

1. Revise as notas de lançamento de cada major version no seu caminho de atualização e atualize o código do cliente para garantir compatibilidade.

2. (Opcional) Use a restauração de dados para testar a compatibilidade da versão principal.

   Importante

   A restauração de dados gera custos adicionais.

   1. Use data restoration para criar uma nova instância com a mesma versão principal da sua instância atual.

   2. Upgrade the major version of the new instance.

   3. Teste seu cliente atualizado na nova instância para verificar problemas de compatibilidade.

      Se surgirem problemas de compatibilidade, use as mensagens de erro para depurar e modifique o código do cliente.

   4. Após concluir o teste, libere a nova instância.

Procedimento

1. Faça login no console do ApsaraDB for MongoDB.

2. No painel de navegação à esquerda, clique em Replica Set Instances ou Sharded Cluster Instances conforme a arquitetura da instância.

3. No canto superior esquerdo da página, selecione o grupo de recursos e a região onde sua instância está localizada.

4. Clique no ID da instância de destino ou clique em Manage na coluna Actions da instância.

5. Na seção Specification Information, passe o mouse sobre Upgrade Database Version e clique na versão principal de destino.

6. Na caixa de diálogo Upgrade Database Version, clique em Confirm.

Nota

Após a conclusão da atualização, se o console ainda indicar que a atualização está em andamento, atualize a página no navegador para visualizar o status mais recente.