Extensão de migração do Azure Cosmos DB para MongoDB vCore para Azure Data Studio (versão prévia)

Artigo
04/22/2024

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

Importante

Atualmente, essa extensão não dá suporte aos seguintes cenários:

Migração online do Azure Cosmos DB para MongoDB vCore.
Migrações online/offline para 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

Uma conta existente do Azure Cosmos DB para MongoDB vCore.
- Caso não tenha 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.

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.

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

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.

Abra o gerenciador de extensões no Azure Data Studio. Selecione o ícone de extensões ou selecione Extensões no menu Exibir.
Insira Cosmos na barra de pesquisa.
Selecione a extensão Migração do Azure Cosmos DB para MongoDB e veja os detalhes dela.
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.

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

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

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.

Selecione Conectar.
Abra o menu de contexto da nova conexão no painel Conexões. Em seguida, selecione Gerenciar.
Selecione Migração do Azure Cosmos DB.

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.

Localize e navegue até a guia Painel. Em seguida, selecione Avaliar e migrar bancos de dados.
Conclua o assistente a fim de fornecer detalhes à extensão para que ela possa executar 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.
  
  Dica
  
  Esse é um campo opcional, fornecendo o caminho dos logs para gerar insights mais detalhados no nível da coleta. Quando a pasta de logs não é especificada, a ferramenta usa as informações do comando serverStatus 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, verifique se houve tempo suficiente desde a reinicialização mais recente do servidor.
4. Forneça o caminho para os Logs de avaliação de dados.
  
  Dica
  
  Embora esse campo permaneça opcional, a inclusão de logs de avaliação de dados pode oferecer insights 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 é fornecido posteriormente 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.
Depois que a validação for bem-sucedida, selecione Iniciar avaliação para executar a avaliação.
Dependendo do tamanho do servidor de origem, a avaliação leva alguns minutos. Aguarde a conclusão da avaliação antes de continuar.
Depois que a avaliação for concluída, você deverá ter um relatório de avaliação.
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.
Selecione Baixar relatório para obter um relatório consolidado para download.
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.

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 a conta vCore do Azure Cosmos DB para MongoDB de destino.

Na tela do relatório de avaliação, selecione os bancos de dados que você planeja migrar. Em seguida, selecione Avançar.
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 todas as credenciais de conexão necessárias para se conectar à conta.
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 é compatível com instâncias de origem ou de destino habilitadas para o ponto de extremidade privado do MongoDB.
- Configure a instância de origem do MongoDB para permitir conexões de datacenters globais do Azure.
- Adicione exceções de firewall à conta de destino vCore do Azure Cosmos DB for MongoDB para permitir conexões de datacenters globais do Azure.
- Para localizar as informações relevantes do intervalo de IP, faça download de JSON dos intervalos de endereços globais do IP do Azure e procure "AzureCloud.{Target Cosmos DB Account Region}" no arquivo JSON.
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).

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

Importante

Caso esteja usando o Serviço de Migração de Banco de Dados pela primeira vez, verifique se o provedor de recursos Microsoft.DataMigration está registrado em sua assinatura.
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.
Selecione Iniciar migração para iniciar a transferência de dados usando o serviço de migração selecionado.
Exiba o status da migração na página do painel depois que os trabalhos forem inicializados.
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.

Observação

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ê 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.
Quando o trabalho for concluído, o status da migração indicará êxito.

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.

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