Compartilhar via


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

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. Você pode usar esta extensão para:

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

Importante

Atualmente, essa extensão não dá suporte aos 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 Azure Cosmos DB for MongoDB com base em RU.

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

Pré-requisitos

Preparar-se

Antes de iniciar a migração, realize o planejamento antecipado e tome decisões sobre sua migração antes de mover realmente 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. Acesse o portal do Azure e navegue até sua assinatura.
  2. No menu à esquerda, selecione Provedores de recursos em Configurações.
  3. Use a caixa de pesquisa na parte superior para localizar o Microsoft.DataMigration.
  4. Caso não esteja cadastrado, selecione-o e clique no botão Registrar.

CLI do Azure:

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

PowerShell:

  1. Abra o Azure Cloud Shell ou seu PowerShell local.
  2. Execute o seguinte comando para registrar o provedor 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 iniciar 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. Insira Cosmos na barra de pesquisa.

  3. Selecione a extensão Migração do Azure Cosmos DB para MongoDB e veja os detalhes dela.

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

  4. Selecione Instalar.

Definir as configurações da extensão

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

  1. Acesse as extensões e selecione Migração do Azure Cosmos DB for MongoDB, escolha o ícone Gerenciar configurações e selecione as configurações da extensão.

    Captura de tela da seleção das configurações de extensão.

  2. Nas configurações de extensão para essa extensão, forneça o Assessment path para alterar o local em que os metadados de avaliação estão armazenados. Se for deixado em branco, o local padrão será usado.

Conectar-se à origem do MongoDB

Use a extensão pela primeira vez para se conectar à instância de origem existente do MongoDB. Verifique se você tem as credenciais de conexão para a origem 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 tela da barra de menus de conexões na extensão.

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

    Valor
    Tipo de conexã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 do MongoDB de origem existente.
    Grupo de servidor Default
    Nome (opcional) Forneça um nome exclusivo para esta conexão.
  3. Selecione Conectar.

  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 tela da tela do banco de dados de Avaliação de Migração.

Ler uma avaliação

A avaliação examina os ativos e a utilização de dados atuais do MongoDB. Em seguida, o recurso de avaliação gera um relatório abrangente que ajuda a identificar as ações necessárias a serem realizadas 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 no recurso de migração da extensão.

  2. Conclua o assistente a fim de fornecer detalhes à extensão para que ela possa executar uma avaliação.

    Captura de tela 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.

      Dica

      Esse é um campo opcional, no entanto, especificar o caminho de 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 comando serverStatus para executar a avaliação.

      O comando serverStatus retorna o uso do recurso somente desde a última reinicialização. Portanto, você precisará garantir que passou 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.

      Dica

      Embora esse campo seja opcional, fornecer logs de avaliação de dados pode gerar insights mais detalhados sobre a carga de trabalho. Esses logs são obtidos por meio da verificação de dados e da leitura de logs detalhados. avaliação de dados é executada independentemente como uma CLI antes de iniciar a avaliação de migração, e o JSON resultante é então 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. Depois que a validação for bem-sucedida, selecione Iniciar avaliação para executar a avaliação.

    Captura de tela dos detalhes da avaliação depois que as credenciais serem validadas.

  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 tela de uma nova avaliação em andamento.

  5. Depois que a avaliação for concluída, você deverá ter um relatório de avaliação.

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

  6. No relatório de avaliação, selecione o nome da instância para examinar 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 de origem do MongoDB.

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

  8. Estude o relatório de avaliação a fim de identificar as ações necessárias 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ê poderá sair do processo e lidar com eles mais tarde. Depois que os problemas forem resolvidos, você poderá voltar e reiniciar o processo de avaliação e migração.

Fazer 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 a conta Azure Cosmos DB for MongoDB com base 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 Avançar.

    Captura de tela de como selecionar o banco de dados para migração.

  2. Restrinja as listas para Selecionar a conta de destino do Azure Cosmos DB para MongoDB filtrando por assinatura e, em seguida, 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 do Azure Cosmos DB for MongoDB de destino.

  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 Àvançar para configurar o Serviço de Migração de Banco de Dados do Azure (DMS).

    Captura de tela do mapeamento de coletas da origem para o destino.

    Aviso

    Optar por Migrar uma coleção existente substituirá toda a coleção, resultando em perda de dados irrecuperável. Tenha cuidado ao escolher essa 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 tela da opção para escolher um serviço de migração.

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

    • A migração online copia os dados da coleção, garantindo que as atualizações também sejam replicadas durante o processo. Esse método é vantajoso com tempo de inatividade mínimo, permitindo operações contínuas para a continuidade dos negócios. Use essa opção quando as operações contínuas forem cruciais e a redução do 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. Funciona bem quando o uso de uma cópia estática do banco de dados é aceitável e as atualizações em tempo real não são essenciais.
  7. Selecione Avançar para exibir o resumo da migração. Depois de examinar e confirmar os detalhes, selecione Criar esquema para criar recursos na conta de destino.

    Captura de tela da opção para exibir 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. Selecione OK para confirmar.

    Captura de tela do pop-up Confirmar configurações, para verificar as configurações do 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 dashboard em intervalos frequentes

Observação

Se você tiver selecionado mais de 50 coleções para migrar, o trabalho de migração será agrupado em lotes 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 o status da 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 assim que todas as tarefas de migração de dados são concluídas.

Captura de tela de coletas 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 êxito.

Captura de tela de êxito no status da migração.

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

Monitorando migrações online

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é que sejam finalizados manualmente selecionando Substituição.

Captura de tela do status da migração online.

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

  1. O botão Substituição é habilitado quando o Carregamento de Dados Inicial é concluído 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 substituição 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 duplicação na tabela e aguarde até que a métrica "Alterações de replicação reproduzidas" se estabilize. Uma métrica estável de "Alterações de replicação reproduzidas" indica que todas as atualizações da origem foram copiadas com êxito para o destino.

  4. Selecione Substituição quando a lacuna de duplicação for mínima para todas as coleções e a métrica "Alterações de duplicaçã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. No diálogo pop-up. Selecione Concluir substituição.
    Captura de tela do pop-up de substituição de migração online.

    Observação

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

  7. Aguarde até que o status mude para Bem-sucedido.

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

Exibir migrações e avaliações anteriores

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

  1. Para exibir 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 no computador 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 exibir 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 no computador atual.

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

Próxima etapa