Upgrade the Major Version of an ApsaraDB for MongoDB Database - ApsaraDB for MongoDB: Central de Documentação do Alibaba Cloud

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, recomendamos que o uso de disco da instância não ultrapasse 90%. A atualização grava arquivos temporários. Se o espaço em disco disponível for insuficiente, como menos de 20% da capacidade total do disco, a atualização pode falhar ou causar falhas na instância. Caso o espaço em disco disponível não atenda ao requisito, aumente o disco primeiro. Inicie a atualização somente após o espaço em disco disponível atingir pelo menos 20% da capacidade total do disco.
Processo e impacto da atualização:
- Reinícios automáticos: 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 do horário 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 sua instância da 4.4 para a 5.0, poderá haver uma queda perceptível no desempenho de gravação.
  Nota
  - Para atualizações de várias versões, como da v3.0 para a v4.2, o sistema executa a atualização sequencialmente por cada versão intermediária. Ocorre uma desconexão transitória após a atualização de cada versão.
  - Recomendamos que as 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 a uma instância garante que o nó conectado seja sempre o nó primário. Isso evita que as operações de leitura e gravação da sua aplicação sejam afetadas por um failover. Para obter 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 obter 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: A duração da atualização depende de fatores como o volume de dados, o número de bancos de dados e tabelas, e a diferença entre as versões. As estimativas a seguir servem apenas como referência, pois os tempos reais podem variar.
- Instâncias com discos em cloud: Aproximadamente 15 minutos.
- Instâncias com discos locais: Para atualizações para uma versão adjacente, a atualização leva vários minutos, semelhante a uma reinicialização de instância.
- Uma atualização de 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 reinicialização 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 do horário de pico e garanta que a aplicação possua um mecanismo de reconexão.

Caminhos de atualização compatíveis

Você pode 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 de acordo com 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 em cloud	MongoDB 4.0	Não há versão principal superior disponível para atualização.
Arquitetura standalone	Uso geral com disco em cloud	MongoDB 3.4	Compatível com atualização para o MongoDB 4.0.
Arquitetura de replica set	Uso geral com disco em cloud Dedicada com disco em 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 causar uma diminuição no desempenho de gravação e um aumento na latência de gravação. Confirme se esse impacto é aceitável antes de atualizar.
	Uso geral com disco local Dedicada com disco local Servidor Físico Dedicado	MongoDB 4.2	A atualização in-place não é compatível. Para atualizar a versão principal, você pode crie uma nova instância e usá-la 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 de cluster sharded	Dedicada com disco em 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 causar uma diminuição no desempenho de gravação e um aumento na latência de gravação. Confirme se esse impacto é aceitável antes de atualizar.
	Uso geral com disco local Dedicada com disco local Servidor Físico Dedicado	MongoDB 4.2	A atualização in-place não é compatível. Para atualizar a versão principal, você pode crie uma nova instância e usá-la 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

Se você precisar 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, em seguida, use o Data Transmission Service (DTS) para migrar os dados da origem para a nova instância.

Consulte os seguintes tópicos para obter instruções sobre migração de dados:

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 e usar uma configuração de conexão Spring XML, recomendamos atualizar o driver para a versão 4.11.2. Você pode manter as configurações de parâmetros existentes, como replica-set, socket-timeout e outras. Se você ainda usa um driver mais antigo, como o 3.3, atualize para o 3.6 ou superior para garantir suporte total aos novos recursos.

Revise as notas de lançamento de cada major version no seu caminho de atualização e atualize o código do seu cliente para garantir a compatibilidade.
(Opcional) Use a restauração de dados para testar a compatibilidade da versão principal.

Importante
A restauração de dados incorre em custos adicionais.
1. Use data restoration e crie 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 se há problemas de compatibilidade.
  
  Depure e modifique o código do seu cliente usando as mensagens de erro, caso surjam problemas de compatibilidade.
4. Após a conclusão do teste, libere a nova instância.

Procedimento

Faça login no console do ApsaraDB for MongoDB.
No painel de navegação à esquerda, clique em Replica Set Instances ou Sharded Cluster Instances com base na arquitetura da instância.
No canto superior esquerdo da página, selecione o grupo de recursos e a região onde sua instância está localizada.
Clique no ID da instância de destino ou clique em Manage na coluna Actions da instância.
Na seção Specification Information, passe o mouse sobre Upgrade Database Version e clique na versão principal de destino.
Na caixa de diálogo Upgrade Database Version, clique em Confirm.

Nota

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