Extensão de migração vCore do Azure Cosmos DB para MongoDB para 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 vCore.
  • Execute a operação de migração com bancos de dados e coleções selecionados para o Azure Cosmos DB for MongoDB vCore.

Importante

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

  • Migração online para o Azure Cosmos DB para MongoDB vCore.
  • Migrações Online/Offline para o Azure Cosmos DB para MongoDB RU.

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

Pré-requisitos

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.

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 "source" 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, fornecendo que o caminho dos logs produza informações mais detalhadas no nível da coleção. Quando a pasta de log não é especificada, a ferramenta depende das informações do serverStatus comando para a avaliação. Lembre-se de que o comando 'serverStatus' relata o uso do recurso somente desde a última reinicialização do servidor. Para obter uma avaliação que reflita com precisão sua carga de trabalho real, certifique-se de que tenha decorrido tempo suficiente desde a reinicialização mais recente do servidor.

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

      Gorjeta

      Embora esse campo permaneça opcional, a inclusão de logs de avaliação de dados pode oferecer informações mais abrangentes sobre a carga de trabalho. Esses logs são adquiridos por meio da varredura de dados e da revisão de logs detalhados. A avaliação de dados é executada independentemente como uma interface de linha de comando (CLI) antes de iniciar a avaliação de migração, e o JSON resultante é subsequentemente 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 offline

Agora, use o relatório de avaliação para executar uma migração offline de seus dados da instância do MongoDB de origem para sua conta vCore do Azure Cosmos DB para MongoDB 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 todas 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.

    Importante

    Atualmente, a extensão não suporta instâncias MongoDB de origem ou de destino habilitadas para Private Endpoint.

    • Configure a instância do MongoDB de origem para permitir conexões de datacenters globais do Azure.
    • Adicione exceções de firewall à conta de destino vCore do Azure Cosmos DB para MongoDB para permitir conexões de datacenters globais do Azure.
    • Para localizar as informações relevantes do intervalo de IP, baixe JSON dos intervalos de endereços IP globais do Azure e procure "AzureCloud.{ Target Cosmos DB Account Region}" dentro do arquivo JSON.

  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.

    Importante

    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.

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

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

  8. Exiba 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.

  9. Selecione uma migração específica na lista de migrações para exibir mais detalhes. Aguarde a conclusão da migração antes de continuar.

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

    Nota

    Você não precisa permanecer conectado ao serviço de migração ou ao Azure Data Studio enquanto os trabalhos de migração são executados remotamente e de forma assíncrona. Os trabalhos de migração são executados no serviço de migração e o status será atualizado no painel em intervalos frequentes.

    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.

  10. Quando o trabalho estiver concluído, o status da migração indicará sucesso.

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

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