Extensão de migração do Azure Cosmos DB para MongoDB para o Azure Data Studio (visualização)

A extensão de migração do Azure Cosmos DB para MongoDB ajuda você a migrar suas cargas de trabalho do MongoDB para o Azure Cosmos DB. Pode utilizar esta extensão para:

• Execute uma avaliação completa sobre sua carga de trabalho e descubra as ações necessárias que você precisa tomar para migrar suas cargas de trabalho para o Azure Cosmos DB para MongoDB baseado em vCore.
• Execute a operação de migração com bancos de dados e coleções selecionados para o Azure Cosmos DB para MongoDB baseado em vCore.

Pré-requisitos

• Uma conta existente do Azure Cosmos DB para MongoDB baseada em vCore.
  • Se você não tiver uma assinatura do Azure, crie uma conta gratuitamente.
• Versão mais recente do Azure Data Studio.
• MongoDB executando a versão 3.2 ou superior.
• Adicione exceções de firewall ao MongoDB de origem e à conta de destino do Azure Cosmos DB para MongoDB baseada em vCore para aceitar conexões de datacenters globais do Azure.

Preparação

Antes de iniciar a migração, realize o planejamento inicial e a tomada de decisões sobre sua migração antes de realmente mover quaisquer dados.

• Para obter mais informações sobre o planejamento de pré-migração para a API para MongoDB vCore, consulte as etapas de pré-migração para o Azure Cosmos DB para MongoDB baseado em vCore,
• Para obter mais informações sobre o planejamento de pré-migração para a API para RU do MongoDB, consulte as etapas de pré-migração para o Azure Cosmos DB para MongoDB baseado em RU

Instalar a extensão

Instale a extensão de migração do Azure Cosmos DB para MongoDB no Azure Data Studio antes de começar a migração.

1. Abra o gerenciador de extensões no Azure Data Studio. Selecione o ícone de extensões ou selecione Extensões no menu Exibir.

2. Entre Cosmos na barra de pesquisa.

3. Selecione a extensão Azure Cosmos DB Migration for MongoDB e exiba seus detalhes.

   

4. Selecione Instalar.

Definir configurações de extensão

Você pode definir algumas configurações de extensão depois de instalar a extensão. Este passo é opcional. Se nenhuma configuração for explicitamente configurada, a extensão usará as configurações padrão.

1. Vá para extensões e selecione Azure Cosmos DB Migration for MongoDB, selecione o ícone gerenciar configurações e selecione configurações de extensão.

   

2. Em Configurações de extensão para essa extensão, forneça o Assessment path para alterar o local onde os metadados de avaliação estão armazenados. Se deixado em branco, o local padrão é usado.

Conecte-se à fonte do MongoDB

Use a extensão pela primeira vez para se conectar à instância de origem existente do MongoDB. Certifique-se de ter as credenciais de conexão para a fonte prontas antes de iniciar esta seção.

1. Localize o ícone de conexões na barra de menus e selecione Nova conexão.

   

2. No painel Conexão, preencha os seguintes campos:

   	Value
   Tipo de ligação	Azure Cosmos DB for MongoDB
   Cadeia de conexão/parâmetros	Use a cadeia de conexão ou os parâmetros para sua instância MongoDB de origem existente.
   Grupo de servidores	Default
   Nome (opcional)	Forneça um nome exclusivo para essa conexão.

3. Selecione Ligar.

4. Abra o menu de contexto da nova conexão no painel Conexões. Em seguida, selecione Gerenciar.

   

5. Selecione Migração do Azure Cosmos DB.

   

Executar uma avaliação

A avaliação examina sua propriedade e utilização de dados atuais do MongoDB. Em seguida, o recurso de avaliação gera um relatório abrangente que ajuda você a identificar as ações necessárias a serem tomadas antes de migrar suas cargas de trabalho para o Azure Cosmos DB para MongoDB.

1. Localize e navegue até a guia Painel . Em seguida, selecione Avaliar e migrar bancos de dados.

   

2. Conclua o assistente para fornecer detalhes à extensão para que ela possa realizar uma avaliação.

   

   1. No campo Nome da avaliação , insira um título.

   2. Selecione a conta de destino do Azure Cosmos DB para MongoDB na lista suspensa Oferta .

   3. Forneça o caminho para os logs do MongoDB.

      Gorjeta

      Este é um campo opcional, no entanto, especificar o caminho dos logs resulta em descobertas mais granulares no nível da coleção. Quando a pasta de log não é especificada, a ferramenta usa detalhes do serverStatus comando para executar a avaliação.

      O serverStatus comando retorna o uso do recurso somente desde a última reinicialização, portanto, você precisa garantir que tenha passado tempo suficiente desde a última reinicialização do servidor para obter uma avaliação que reflita com precisão sua carga de trabalho real.

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

      Gorjeta

      Embora esse campo seja opcional, o fornecimento de logs de avaliação de dados pode gerar informações mais detalhadas sobre a carga de trabalho. Estes registos são obtidos através da digitalização de dados e da leitura de registos detalhados. A avaliação de dados é executada independentemente como uma CLI antes de iniciar a avaliação de migração, e o JSON resultante é fornecido aqui. Faça o download da CLI de avaliação de dados aqui.

   5. Selecione Executar validação para validar as entradas de avaliação.

3. Quando a validação for bem-sucedida, selecione Iniciar avaliação para executar a avaliação.

   

4. Dependendo do tamanho do servidor de origem, a avaliação leva alguns minutos. Aguarde a conclusão da avaliação antes de continuar.

   

5. Após a conclusão da avaliação, deverá ter um relatório de avaliação.

   

6. No relatório de avaliação, selecione o nome da instância para revisar uma lista de problemas em todo o servidor. Selecione um banco de dados específico para exibir problemas que só são aplicáveis ao banco de dados selecionado.

   

7. Selecione Baixar relatório para obter um relatório consolidado para download.

8. Estude o relatório de avaliação para identificar quaisquer ações que você precise tomar para uma migração perfeita de suas cargas de trabalho no Azure Cosmos DB para MongoDB. Antes de passar para a próxima etapa, certifique-se de que todos os problemas de bloqueio relatados na avaliação sejam tratados. Se houver problemas não resolvidos, você pode sair do processo e tratá-los mais tarde. Uma vez resolvidos os problemas, você pode voltar e reiniciar o processo de avaliação e migração.

Executar uma migração

Agora, use o relatório de avaliação para executar uma migração de seus dados da instância do MongoDB de origem para sua conta do Azure Cosmos DB para MongoDB baseada em vCore de destino.

1. Na tela do relatório de avaliação, selecione os bancos de dados que você planeja migrar. Em seguida, selecione Seguinte.

   

2. Restrinja as listas para Selecione a conta de destino do Azure Cosmos DB para MongoDB filtrando por assinatura e, em seguida, por grupo de recursos. Em seguida, forneça as credenciais de conexão necessárias para se conectar à conta.

   

3. Selecione Testar conexão para validar as credenciais da conta do Azure Cosmos DB para MongoDB. Selecione Avançar para navegar até o mapeamento de coleções da origem para o destino.

4. Escolha Ignorar ou Migrar para cada coleção na lista de mapeamentos. As coleções que já existem no destino são marcadas automaticamente com um ícone e definidas como Ignorar por padrão. Selecione Avançar para configurar o Serviço de Migração de Banco de Dados do Azure (DMS).

   

   Aviso

   Optar por Migrar uma coleção existente substituirá toda a coleção, resultando em perda irrecuperável de dados. Tenha cuidado ao escolher esta opção.

5. Escolha uma instância existente do Serviço de Migração de Banco de Dados do Azure na lista suspensa ou selecione Criar Novo para criar um novo serviço de migração. O Serviço de Migração de Banco de Dados do Azure é um serviço que migra dados de e para plataformas de dados do Azure usando a infraestrutura de nuvem para transferência de dados, em vez de depender de recursos locais.

   

6. Selecione o modo de migração mais apropriado para o seu caso de uso.

   • A migração on-line copia os dados de coleta, garantindo que as atualizações também sejam replicadas durante o processo. Este método é vantajoso com o mínimo de tempo de inatividade, permitindo operações contínuas para a continuidade dos negócios. Use essa opção quando as operações contínuas forem cruciais e reduzir o tempo de inatividade for uma prioridade.
   • A migração offline captura um instantâneo do banco de dados no início, oferecendo uma abordagem mais simples e previsível. Ele funciona bem quando o uso de uma cópia estática do banco de dados é aceitável, e atualizações em tempo real não são essenciais.

7. Selecione Avançar para exibir o resumo da migração. Depois de revisar e confirmar os detalhes, selecione Criar esquema para criar recursos na conta de destino.

   

8. Selecione Iniciar migração para iniciar a transferência de dados usando o serviço de migração selecionado.

   

9. No pop-up Confirmar configurações, verifique se as configurações do firewall atendem aos requisitos. Selecionar OK para confirmar.

   

As tarefas de migração de dados são executadas no Serviço de Migração de Banco de Dados do Azure, portanto, você não precisa estar conectado aos ambientes de origem e destino durante a migração de dados. O status é atualizado no painel em intervalos frequentes

1. Monitore o status da migração na página do painel depois que os trabalhos forem inicializados.

   

2. Para ver mais detalhes, selecione uma migração específica na lista de migrações.

Monitorando migrações offline

O status é atualizado automaticamente quando todas as tarefas de migração de dados são concluídas.

Depois que os dados são copiados com êxito da origem para o destino, o status das migrações offline indica sucesso.

• Altere a cadeia de conexão em seus aplicativos para apontar para a conta de destino.

Monitoramento de migrações on-line

As migrações online, ao contrário das migrações offline, não são concluídas automaticamente. Em vez disso, eles são executados continuamente até serem finalizados manualmente selecionando Substituição.

Para concluir a migração online, siga estas etapas na ordem dada:

1. O botão Substituição é ativado assim que a Carga Inicial de Dados é concluída para todas as coleções. A migração está atualmente na fase de replicação, copiando continuamente as atualizações da instância de origem para a instância de destino para mantê-la atualizada com as alterações mais recentes.

2. Quando estiver pronto para executar a transferência de migração, interrompa todas as transações de entrada para as coleções de origem que estão sendo migradas.

3. Monitore as alterações de replicação na tabela e aguarde até que a métrica 'Alterações de replicação reproduzidas' se estabilize. Uma métrica estável 'Replication Changes Played' indica que todas as atualizações da origem são copiadas com êxito para o destino.

4. Selecione Substituição quando a lacuna de replicação for mínima para todas as coleções e a métrica 'Alterações de replicação reproduzidas' estiver estável.

5. Valide manualmente se a contagem de linhas é a mesma entre as coleções de origem e de destino.

6. Na caixa de diálogo pop-up. Selecione Concluir Substituição.
   

   Nota

   Executar a operação de substituição sem validar que a origem e o destino estão sincronizados pode resultar em perda de dados.

7. Aguarde até que o status mude para Succeeded.

8. Atualize a cadeia de conexão em seus aplicativos para apontar para a conta de destino.

Ver migrações e avaliações anteriores

Muitas vezes, é útil rever avaliações e migrações anteriores. A extensão fornece uma interface para rever resumos de avaliações e migrações anteriores. A extensão também oferece a capacidade de revisar relatórios de avaliação histórica detalhados.

1. Para visualizar migrações anteriores, selecione a guia Migrações na barra de ferramentas. A lista de migrações contém todas as migrações que foram iniciadas na máquina atual. Você pode selecionar uma migração específica na lista para obter mais detalhes.

   

2. Para ver avaliações anteriores, selecione a guia Avaliações na barra de ferramentas. A lista de avaliações contém todas as avaliações que foram iniciadas na máquina atual.

   

Próximo passo