Avaliar uma instalação do MongoDB e planejar a migração para o Azure DocumentDB

Execute tarefas de planejamento antecipadas e tome decisões críticas antes de migrar seus dados para o Azure DocumentDB. Essas decisões fazem com que o processo de migração seja executado sem problemas.

Pré-requisitos

• Uma assinatura do Azure

  • Se você não tiver uma assinatura do Azure, crie uma conta gratuita

• Um cluster existente do Azure DocumentDB

  • Se você não tiver um cluster, crie um novo cluster

• Uma instalação existente do MongoDB.

Avaliar a compatibilidade e a preparação de seus recursos para migração

Antes de planejar a migração, avalie o estado dos recursos existentes do MongoDB para ajudar a planejar a migração. Use a extensão migração do Azure DocumentDB no VS Code para avaliar a compatibilidade e a preparação de suas cargas de trabalho ao planejar a migração do MongoDB para o Azure DocumentDB. A avaliação completa de ponta a ponta para descobrir as ações que você precisa tomar para executar suas cargas de trabalho sem problemas no Azure DocumentDB. O relatório de avaliação apresenta resultados nos níveis de conta, banco de dados e coleção, cada um marcado como Crítico, Aviso ou Informativo com base na gravidade para auxiliar a priorização. O relatório inclui:

• Recursos e sintaxe sem suporte: ele sinaliza recursos, comandos, sintaxe de consulta e tipos de índice sem suporte do MongoDB, com frequência de uso para priorizar correções.

• Recomendações Específicas para Recursos: Cada descoberta inclui o nome do recurso afetado, recomendações acionáveis e detalhes técnicos relevantes para remediação.

• Visão geral do ambiente: resume os principais aspectos do ambiente de origem do MongoDB, como versão, licença, tipo de instância e estatísticas para bancos de dados e coleções.

• Compatibilidade e restrições de plataforma: detalha as cotas, limites e possíveis incompatibilidades de chave de fragmento do Azure DocumentDB para cargas de trabalho fragmentadas.

Executar uma avaliação

1. Para começar, instale a extensão migração do Azure DocumentDB no VS Code. Isso instalará automaticamente seu pré-requisito, a extensão DocumentDB para VS Code .

2. Abra a extensão DocumentDB para VS Code .

3. Adicione o servidor MongoDB que você deseja avaliar para migração à lista Conexões do DocumentDB.

4. Expanda a conexão selecionada, clique com o botão direito do mouse e escolha Migração de Dados....

5. Na paleta de comandos, selecione Avaliação de Pré-Migração para o Azure DocumentDB.

6. O assistente de avaliação orienta você por três etapas. Na etapa Iniciar Validação , selecione Executar Validação para verificar credenciais, pré-requisitos e conectividade antes de prosseguir.

   Importante

   Para executar uma avaliação, o usuário conectado do MongoDB deve ter as funções readAnyDatabase e clusterMonitor atribuídas na instância de origem.

7. Na etapa Preencher Detalhes da Avaliação , forneça as entradas necessárias:

   • Insira um título no campo Nome da Avaliação .
   • Selecione vCore na lista suspensa Oferta.
   • Forneça o caminho para os logs do MongoDB.

   Dica

   Embora seja opcional, especificar o caminho dos logs permite descobertas mais detalhadas no nível da coleção. Se omitida, a ferramenta depende de dados do serverStatus comando, o que reflete apenas o uso de recursos desde a última reinicialização. Permitir tempo suficiente para passar após a última reinicialização do servidor para uma avaliação precisa da carga de trabalho.

   • Forneça o caminho para os logs de avaliação de dados.

   Dica

   Embora opcional, fornecer logs de avaliação de dados aprimora as informações sobre cargas de trabalho. Esses logs são gerados por meio da verificação de dados e da leitura de logs detalhados. A avaliação de dados é executada independentemente como uma CLI antes de iniciar a avaliação de migração e o JSON resultante é usado aqui. Faça o download da CLI de avaliação de dados aqui.

8. Selecione Iniciar Avaliação para iniciar o processo de avaliação.

9. Na etapa Obter Seu Relatório , aguarde a conclusão da avaliação. A duração depende do tamanho do servidor de origem.

10. Depois que a avaliação for concluída, selecione Baixar Relatório para recuperar o relatório HTML.

Exibir avaliações anteriores

A revisão de avaliações anteriores pode ser valiosa. Use a guia Exibir Avaliações Anteriores para acessar relatórios históricos detalhados. A lista de avaliação inclui todas as avaliações iniciadas no computador atual para a conexão selecionada.

perguntas frequentes

Como proceder se a etapa "Executar Validação" falhar?

Verifique a mensagem de erro exibida na extensão para determinar a causa da falha de validação. Problemas comuns incluem a incapacidade de conectar ao endpoint do MongoDB ou permissões de usuário insuficientes no servidor conectado.

Para executar uma avaliação, verifique se o usuário conectado do MongoDB tem as funções readAnyDatabase e clusterMonitor atribuídas na instância de origem.

Use grantRolesToUser para atribuir as funções necessárias ao usuário atual.

Como posso exibir nomes de coleção e banco de dados em avaliações de "compatibilidade de recursos"?

O serverStatus comando é usado para avaliações de compatibilidade de recursos. No entanto, esse comando não fornece nomes de banco de dados ou coleção, o que impede que a extensão os reporte.

Para obter resultados de avaliação mais detalhados, execute novamente a avaliação e especifique a pasta que contém logs do MongoDB no campo Caminho da Pasta de Log .

Como configurar meu firewall do servidor de origem para evitar problemas de conectividade?

Verifique se a instância do MongoDB de origem permite conexões de entrada do computador.

Quantas avaliações posso executar simultaneamente?

Não há limite para o número de avaliações que você pode executar ao mesmo tempo. No entanto, a execução de várias avaliações em paralelo força os recursos de computação em seu computador e no servidor de origem, potencialmente afetando o desempenho.

Quais informações estão incluídas em um relatório de avaliação?

O relatório começa com os principais detalhes sobre a avaliação, incluindo um resumo do ambiente de origem do MongoDB. Esta seção aborda a versão de origem do MongoDB, o tipo de licença e o tipo de instância. Ele também lista os bancos de dados e coleções avaliados, juntamente com seus resumos de avaliação e preparação para a migração.

As descobertas são categorizadas em Crítico, Aviso e Informativo, ajudando você a priorizá-las com base na importância.

A avaliação inclui verificações para:

Que tipo de logs a extensão gera?

A extensão registra erros, avisos e outros logs de diagnóstico no diretório de log padrão:

• Windows - C:\Users\<username>\.dmamongo\logs\
• Linux - ~/.dmamongo/logs
• macOS - /Users/<username>/.dmamongo/logs

Planejamento de capacidade

Camada de cluster

Comece com uma camada de cluster que se alinha às configurações do banco de dados de origem. Realize testes de carga e desempenho para determinar o equilíbrio ideal entre custo e desempenho.

Camada de armazenamento

Verifique se sua conta de destino está provisionada com armazenamento adequado para atender aos seus requisitos de dados durante e após a migração. Comece migrando um pequeno conjunto de dados para avaliar o consumo de armazenamento e, em seguida, dimensione a estimativa com base no tamanho total dos dados para determinar a alocação de armazenamento necessária. Reserve espaço extra para acomodar dados de entrada e crescimento futuro.

Próxima etapa