Partilhar via

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

  • Artigo

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.

Importante

Atualmente, esta extensão não suporta os seguintes cenários:

  • Migração em que a conta de origem ou de destino está habilitada para o Ponto de Extremidade Privado.
  • Migrações Online/Offline para o Azure Cosmos DB baseado em RU para MongoDB.

Para obter mais informações sobre soluções alternativas para a API do MongoDB vCore, consulte Opções de migração.

Pré-requisitos

  • Uma conta existente do Azure Cosmos DB para MongoDB baseada em vCore.
  • 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.
  • Se estiver a utilizar o Serviço de Migração de Base de Dados pela primeira vez, certifique-se de que o fornecedor de recursos Microsoft.DataMigration está registado na sua subscrição.

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.

Registrar o provedor de recursos Microsoft.DataMigration em sua assinatura

Para garantir que o provedor de recursos Microsoft.DataMigration esteja registrado em sua assinatura, você pode seguir estas etapas:

Portal do Azure:

  1. Vá para o portal do Azure e navegue até sua assinatura.
  2. No menu à esquerda, selecione Provedores de recursos em Configurações.
  3. Procure Microsoft.DataMigration na caixa de pesquisa na parte superior.
  4. Se não estiver registado, selecione-o e clique no botão Registar.

CLI do Azure:

  1. Abra o Azure Cloud Shell ou seu terminal local.
  2. Execute o seguinte comando para registar o fornecedor de recursos:
az provider register --namespace Microsoft.DataMigration

PowerShell::

  1. Abra o Azure Cloud Shell ou o PowerShell local.
  2. Execute o seguinte comando para registar o fornecedor de recursos:
Register-AzResourceProvider -ProviderNamespace "Microsoft.DataMigration"

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.

    Captura de tela do botão de instalação da extensão de migração do Azure Cosmos DB para MongoDB.

  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.

    Captura de tela da seleção de 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.

    Captura de ecrã da barra de menus de ligações na extensã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.

    Captura de tela da tela Gerenciar banco de dados.

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

    Captura de ecrã do ecrã da base de dados Avaliação da Migração.

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.

    Captura de tela da guia Painel dentro do recurso de migração da extensão.

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

    Captura de ecrã dos detalhes da avaliação antes de as credenciais serem validadas.

    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.

    Captura de ecrã dos detalhes da avaliação após a validação das credenciais.

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

    Captura de ecrã de uma nova avaliação em curso.

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

    Captura de tela do novo relatório de avaliação para a instância MongoDB de origem.

  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.

    Captura de tela do novo relatório de avaliação para o banco de dados selecionado na instância MongoDB de origem.

  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.

    Captura de tela do banco de dados selecionado para migração.

  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.

    Captura de tela da seleção de uma conta de destino do Azure Cosmos DB para MongoDB.

  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).

    Captura de tela do mapeamento de coleções da origem para o destino.

    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.

    Captura de ecrã da opção para escolher um serviço de migração.

  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.

    Captura de ecrã da opção para ver o resumo da migração.

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

    Captura de tela da opção para iniciar uma migração usando o serviço de migração.

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

    Captura de ecrã do pop-up Confirmar definições para verificar as definições da firewall.

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

Nota

Se você selecionou mais de 50 coleções para migrar, o trabalho de migração será agrupado em vários trabalhos no serviço de migração, cada um contendo no máximo 50 coleções.

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

    Captura de tela do painel com status de migração.

  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.

Captura de tela de coleções com status de migração.

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

Captura de tela do sucesso no status de migração.

  • 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.

Captura de ecrã do estado da migração online.

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.
    Captura de ecrã do pop-up de substituição de migração online.

    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.

    Captura de tela da lista de todas as migrações criadas usando a extensão.

  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.

    Captura de tela da lista de todas as avaliações realizadas usando a extensão.

Próximo passo

Consulte as Perguntas frequentes sobre a extensão de migração do Azure Cosmos DB para MongoDB