View a markdown version of this page

Atualização da versão principal implementada do Amazon DocumentDB no local - Amazon DocumentDB

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Atualização da versão principal implementada do Amazon DocumentDB no local

Você pode realizar um upgrade de versão principal (MVU) no local do seu cluster Amazon DocumentDB, mantendo os mesmos endpoints, armazenamento e tags. Seus aplicativos continuam funcionando sem modificações. Esse recurso está disponível sem custo adicional em todas as regiões em que o Amazon DocumentDB está disponível.

Importante

Seu cluster ficará indisponível durante o upgrade e passará por várias reinicializações. Não se conecte, leia ou grave no cluster depois de iniciar o upgrade. O tempo de inatividade varia de acordo com o número de coleções, índices, bancos de dados e instâncias. Recomendamos realizar a atualização durante sua janela de manutenção ou horas de baixa utilização.

Depois de atualizado, você não pode fazer o downgrade para uma versão anterior. Você pode restaurar seu snapshot de pré-upgrade em um novo cluster, se necessário.

Caminhos de atualização com suporte

Versão de origem Versão de destino

Amazon DocumentDB 3.6

Amazon DocumentDB 5.0

Amazon DocumentDB 4.0

Amazon DocumentDB 5.0

Amazon DocumentDB 5.0

Amazon DocumentDB 8.0

nota

In-place O MVU não é compatível com clusters globais ou clusters elásticos. Para atualizar um cluster global, remova os clusters secundários, converta o primário em um cluster regional, execute a MVU e recrie o cluster global adicionando clusters secundários usando os mesmos nomes para manter seus endpoints. Você incorrerá em I/O cobranças enquanto o primário atualizado replica os dados para os novos secundários. Para obter detalhes das etapas, consulte, Remover um cluster de um cluster global do Amazon DocumentDB.

Pré-requisitos

  • Tipo de instância — O Amazon DocumentDB 4.0+ não oferece suporte a instâncias db.r4. Modifique todas db.r4.* as db.r5.* instâncias para instâncias ou mais recentes antes da atualização. Consulte Modificar uma instância do Amazon DocumentDB e Classes de instância compatíveis por região.

  • Patches do sistema operacional — aplique todas as ações pendentes de manutenção do sistema operacional em todas as instâncias antes da atualização. Consulte Atualizações do sistema operacional do Amazon DocumentDB.

    nota

    Os patches pendentes do mecanismo em nível de cluster podem ocultar os patches do sistema operacional da instância. Aplique os patches do motor primeiro, se necessário. Consulte Executar uma atualização de patch para a versão do mecanismo de um cluster.

  • Limites de índice em instâncias com capacidade de intermitência (instâncias da família t) — Se você tiver mais de 3.000 índices em instâncias com capacidade de intermitência, aumente a escala primária para pelo menos db.r5.large antes da atualização. Você pode reduzir a escala após a conclusão da atualização.

    Instância Índices máximos para MVU

    db.t4g.medium

    3 mil

    db.t3.medium

    10 mil

  • Grupo de parâmetros — Recomendamos ter um grupo de parâmetros de cluster personalizado para a versão de destino pronto antes da atualização. Se um não for especificado, o grupo de parâmetros padrão para a versão de destino será usado (por exemplo, default.docdb5.0 oudefault.docdb8.0).

  • Instantâneo manual — Crie um instantâneo manual antes da atualização. O processo de atualização cria um instantâneo automático chamadopreupgrade-<name>-<version>-<timestamp>, mas é altamente recomendável ter seu próprio backup. Consulte Criação de um snapshot manual de cluster.

    nota

    O snapshot automático criado pelo processo de atualização não será excluído automaticamente após a conclusão da atualização da versão principal implementada. Esse snapshot não incorrerá em nenhuma cobrança, desde que esteja dentro do período de retenção. É possível optar por excluir esse snapshot depois de verificar uma atualização com êxito do seu cluster.

    Imagem: a caixa de navegação Snapshots mostrando uma tabela de snapshots criados anteriormente.

Práticas recomendadas

Antes da atualização — testando com um clone

  1. Use Clonar um volume para um cluster Amazon DocumentDB para criar um clone do seu cluster. Você não incorrerá em custos de armazenamento, a menos que modifique os dados no clone.

  2. Combine a contagem de instâncias do clone com o cluster de destino para obter uma estimativa de tempo realista.

  3. Execute a MVU no clone e teste totalmente as diferenças funcionais.

  4. Verifique se uma atualização já está agendada executando describe-db-clusterse procurandoPendingModifiedValues.EngineVersion. Se você modificou o cluster e optou por aplicá-lo na próxima janela de manutenção, a agenda não estará visível no console, mas você poderá visualizá-la no AWS CLI:

    aws docdb describe-db-clusters \ --region us-east-1 \ --db-cluster-identifier mydocdbcluster
    "PendingModifiedValues": { "EngineVersion": "5.0.0" },
  5. Se o teste for bem-sucedido, continue com a atualização em seu cluster de produção.

Durante a atualização

É possível monitorar o andamento da atualização da versão principal implementada assinando os eventos de manutenção do cluster. Quando a atualização for concluída, você receberá o evento “A versão principal do cluster de banco de dados foi atualizada”. Esse e outros eventos que ocorrem durante a atualização aparecem na seção Eventos e tags da página de detalhes do cluster no console do Amazon DocumentDB. Em seguida, o status do cluster muda de upgrading paraavailable.

Os seguintes eventos são gerados durante a atualização:

  1. A atualização da versão principal do mecanismo de cluster de banco de dados foi iniciada. O cluster permanece online.

  2. Preparação da atualização em andamento: iniciando pré-verificações de atualização on-line.

  3. Preparação da atualização em andamento: pré-verificações de atualização on-line concluídas.

  4. Colocar o cluster de banco de dados off-line enquanto a instância primária conclui o patch/upgrade processo.

  5. Preparação da atualização em andamento: iniciando as pré-verificações de atualização offline.

  6. Preparação da atualização em andamento: pré-verificações de atualização off-line concluídas.

  7. <version-to><timestamp>Atualização em andamento: Criação de um instantâneo de pré-atualização [preupgrade- <cluster-name>- <version-from>-to- -].

  8. Atualização em andamento: volume de clonagem.

  9. Atualização em andamento: atualizando gravador.

  10. Atualização em andamento: atualizando leitores.

  11. A versão principal do mecanismo do cluster de banco de dados foi atualizada.

Os eventos são visíveis no console, na página Eventos:

Imagem: a caixa de navegação Eventos mostrando uma tabela de eventos de atualização.

A partir do AWS CLI, você pode executar aws docdb describe-eventspara monitorar o progresso da atualização. Para receber notificações automaticamente, use aws docdb create-event-subscriptionpara se inscrever em eventos e encaminhá-los para o Amazon SNS para e-mail, mensagens push ou outros métodos de entrega. Para obter mais informações, consulte Tornar-se assinante de eventos do Amazon DocumentDB.

aws docdb describe-events --source-identifier mydocdbcluster --source-type db-cluster

Esse comando retorna uma saída semelhante à seguinte:

{ "Events": [ { "SourceIdentifier": "mydocdbcluster", "SourceType": "db-cluster", "Message": "Database cluster engine version upgrade started.", "EventCategories": [ "maintenance" ], "Date": "2023-07-11T23:20:32.444000+00:00", "SourceArn": "arn:aws:rds:us-east-1:xxxx:cluster:mycluster" } ] }

Após a atualização

Atenção

Imediatamente após a atualização local da versão principal, seu cluster Amazon DocumentDB preenche novamente os metadados do índice que o mecanismo de banco de dados usa para otimizar os planos de execução de consultas. O desempenho da consulta retorna aos níveis esperados quando esse processo é concluído. Normalmente, ele termina em alguns minutos, mas pode levar até duas horas, dependendo do número de índices em seu cluster.

Não reinicie, faça failover ou escale up/down sua instância de gravador durante esse período, pois isso pode interromper o recálculo dos metadados do índice. Recomendamos esperar até que você observe o desempenho esperado da consulta antes de fazer essas alterações.

Acompanhe o progresso por meio dos seguintes eventos de cluster:

  • Post-upgrade status do cluster: o processo de atualização dos metadados do índice foi iniciado

  • Post-upgrade status do cluster: processo de atualização de metadados do índice concluído em X segundos

Entre em contato com o AWS suporte se o processo de atualização dos metadados do índice não for concluído em três horas ou se você continuar enfrentando problemas de desempenho após a conclusão do processo.

  1. Faça um snapshot manual do cluster atualizado, caso precise restaurar para o estado pós-upgrade. O processo automático de captura instantânea será retomado assim que a atualização da versão principal no local for concluída.

  2. Clusters de tags atualizados da versão 3.6. Adicione uma tag para diferenciar os clusters atualizados da versão 3.6. (verPost-upgrade considerações para clusters atualizados da versão 3.6 ou 4.0).

  3. Atualize seu driver. Para usar novos recursos (por exemplo, agrupamento, visualizações ou compressão Zstd na versão 8.0), atualize para a versão correspondente da API do MongoDB. Para obter mais informações, consulte O que há de novo no Amazon DocumentDB 8.0.

  4. Teste minuciosamente. Valide seu aplicativo em relação ao cluster atualizado.

O que muda após a atualização do Amazon DocumentDB 5.0 para 8.0

Depois de realizar uma atualização de versão principal do Amazon DocumentDB 5.0 para 8.0, os seguintes recursos são habilitados ou alterados:

  • Cotejo. O Amazon DocumentDB 8.0 oferece suporte ao agrupamento. Após a atualização, novas coleções e seus índices, e novos índices em coleções existentes, têm o agrupamento habilitado por padrão.

  • Índice de texto. Novos índices de texto são criados usando o Text Index V2, que usa um analisador de pesquisa de texto atualizado para melhorar a compatibilidade com o MongoDB. Os índices de texto existentes não são afetados.

  • Versão do planejador de consultas. Se você não tiver um grupo de parâmetros personalizado, um novo grupo de parâmetros padrão será criado para o Amazon DocumentDB 8.0 com a versão 3 do Planner selecionada automaticamente. Com a versão 3 do planejador de consultas, as visualizações também estão disponíveis.

  • Compressão. O Amazon DocumentDB 8.0 oferece suporte à compactação de documentos baseada em dicionário usando o algoritmo Zstd. Após a atualização, novas coleções são criadas com a compressão Zstd ativada por padrão. As coleções existentes da versão 5.0 mantêm suas configurações de compactação. Para aproveitar as vantagens da compactação Zstd em coleções existentes, você pode modificar suas configurações de compactação. Para obter mais informações, consulte Dictionary-based compressão.

  • Reconstrução do índice. Se você estiver atualizando do Amazon DocumentDB 5.0 para o Amazon DocumentDB 8.0, nenhuma reconstrução do índice será necessária.

nota

Para obter uma lista completa das diferenças funcionais, consulteCompatibilidade do Amazon DocumentDB com MongoDB.

Post-upgrade considerações para clusters atualizados da versão 3.6 ou 4.0

  • Reconstrução do índice. Uma MVU retém os índices originais. O Amazon DocumentDB 5.0 melhorou a manutenção de índices e a coleta de lixo, especialmente para índices de baixa cardinalidade. Depois da atualização da versão 3.6 ou 4.0, recomendamos reconstruir seus índices para garantir o desempenho ideal da consulta (opcional, envolve mais). I/O Consulte Manutenção de índices usando reIndex.

  • Comparação numérica de subdocumentos (somente 3.6). Os clusters atualizados da versão 3.6 herdam o comportamento da versão 3.6, em que os tipos numéricos nos subdocumentos não são comparados entre os tipos. Por exemplo, {a: {b: NumberLong(1)}} não é igual {a: {b: 1}} em 3,6, mas eles são iguais em 4,0 e posteriores. Esse comportamento afeta todos os clusters atualizados da versão 3.6.

Executar a atualização

Using the Console de gerenciamento da AWS
  1. Faça login no Console de gerenciamento da AWS e abra o console do Amazon DocumentDB.

  2. Na tabela Clusters, selecione o cluster de origem, clique em Ações e, em seguida, em Modificar.

    Imagem: a caixa de navegação Clusters mostrando uma lista dos links de cluster existentes e seus links de instância correspondentes.
  3. Em Especificações do cluster, escolha a versão de destino (por exemplo, 5.0.0 ou 8.0.0) no menu suspenso Versão do mecanismo.

    Imagem: a seção Especificações do cluster da caixa de diálogo Modificar cluster mostrando os campos Identificador do cluster e Versão do mecanismo.
  4. Em Opções de cluster, selecione seu grupo de parâmetros de cluster para a versão do mecanismo de destino. Você pode usar o padrão (por exemplo, default.docdb5.0 ou default.docdb8.0) ou um grupo de parâmetros personalizado que você criou.

    Imagem: a seção Opções de cluster da caixa de diálogo Modificar cluster mostrando o campo Grupo de parâmetros de cluster.
  5. Escolha Continuar, selecione sua preferência de agendamento (aplique imediatamente ou na próxima janela de manutenção) e escolha Modificar cluster.

    Imagem: a caixa de diálogo Modificar cluster mostrando o resumo e o agendamento da modificação para o cluster selecionado.
  6. Monitore o status do cluster na tabela de clusters à medida que ele muda para a atualização:

    Imagem: a caixa de navegação Clusters destacando a coluna Status do cluster que está sendo atualizado.
Using the AWS CLI

Use modify-db-clustercom a --allow-major-version-upgrade bandeira:

aws docdb modify-db-cluster \ ‐‐db-cluster-identifier mydocdbcluster \ ‐‐allow-major-version-upgrade \ ‐‐engine-version 8.0.0 \ ‐‐apply-immediately \ ‐‐cluster-parameter-group mydocdbparametergroup \ ‐‐region us-east-1

Substitua cada um placeholder pelas informações do seu cluster.

Solução de problemas

  • Falha na atualização e reversão. Se a atualização falhar, ela tentará automaticamente uma reversão. Uma reversão bem-sucedida gera o evento: “O cluster de banco de dados está em um estado que não pode ser atualizado”. Seu cluster retorna ao estado de pré-atualização e você pode continuar a usá-lo. Entre em contato com o AWS suporte para solucionar o problema antes de tentar novamente.

  • Post-upgrade desempenho. A degradação temporária do desempenho e a alta utilização da CPU podem ocorrer durante a atualização dos metadados do índice. Se a degradação persistir por mais de 3 horas, entre em contato com AWS o suporte.

Para obter assistência adicional, entre em contato com o AWS Support.