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. Este artigo responde às perguntas frequentes sobre a migração de extensão.
Como executar minha avaliação se a opção "Executar validação" estiver falhando?
Consulte o erro exibido na extensão para ver por que a validação está falhando. Normalmente, o problema é a incapacidade de conexão com o ponto de extremidade do MongoDB. O problema também pode estar relacionado à insuficiência de privilégios do usuário no servidor conectado para executar a avaliação.
Para executar uma avaliação, o usuário conectado ao MongoDb deve ter as atribuições de função readAnyDatabase e clusterMonitor na instância de origem.
Use grantRolesToUser para configurar funções apropriadas para o usuário conectado no momento.
Como ver nomes de coleção e nomes de banco de dados para avaliações na categoria "Compatibilidade de Recursos".
Resposta: a avaliação usa o comando serverStatus para executar a avaliação de compatibilidade de recursos. Como esse comando não fornece os detalhes de nomes de banco de dados ou coleção, a extensão não é capaz de relatá-los.
Para obter detalhes de avaliação mais granulares, execute novamente a avaliação fornecendo o caminho da pasta que contém os logs do criador de perfil do MongoDB no campo Caminho da Pasta de Log.
Como coletar mensagens de log?
Você pode localizar o arquivo de log no seguinte caminho: /var/log/mongodb/mongodb.log. Se o arquivo de log não for encontrado, verifique o local no arquivo de configuração do MongoDB.
Para saber mais, veja Mensagens de log do MongoDB.
Depois que a migração começa, por que não consigo ver a contagem exata de documentos migrados e recebo uma estimativa?
Para reduzir a utilização de recursos na origem durante a migração, a extensão faz uma estimativa do número de documentos que devem sem movidos da origem para o destino em cada coleção, em vez de recuperar a contagem exata.
Por que algumas coleções estão ausentes ou desabilitadas na etapa de mapeamento de coleção?
O Azure Cosmos DB para MongoDB baseado em vCore não oferece suporte a séries temporais ou coleções em cluster. Portanto, esses tipos de coleções estão ausentes ou desabilitados na etapa de mapeamento de coleção.
Por que os modos de exibição estão ausentes ou desabilitados na etapa de mapeamento de coleção se o Azure Cosmos DB for MongoDB com base em vCore oferece suporte a modos de exibição?
O Azure Cosmos DB for MongoDB baseado em vCore dá suporte à criação de novos modos de exibição. No entanto, a extensão de migração não fornece suporte para a migração de exibições existentes.
Depois que a migração for concluída, sempre será possível recriar os as exibições.
Quanto de armazenamento devo esperar utilizar na conta de destino após a migração?
O Azure Cosmos DB for MongoDB com base em vCore não compacta dados no disco. Uma estimativa aproximada típica é duplicar o tamanho do armazenamento consumido pelas coleções na instância de origem do MongoDB para estimar o armazenamento na conta de destino Azure Cosmos DB for MongoDB com base em vCore.
Quais coleções e bancos de dados são ignorados ao migrar do MongoDB para o Azure Cosmos DB for MongoDB com base em vCore?
Os seguintes bancos de dados e coleções são considerados internos para o MongoDB:
| Recurso | |
|---|---|
| Bancos de dados | admin, local, system config |
| Coleções | Qualquer coleção com prefixo system. |
Como os bancos de dados e coleções internos não são necessários no Azure Cosmos DB for MongoDB com base em vCore, a extensão não habilita a migração desses bancos de dados.
É possível migrar bancos de dados e coleções cujos nomes iniciam com números?
Esse é um problema conhecido. A migração não dá suporte a bancos de dados e coleções cujos nomes iniciam com números.
Se eu selecionar várias coleções para migrar, elas serão migradas em paralelo?
Cada tarefa de migração no Serviço de Migração de Banco de Dados do Azure fornece dois trilhos para a migração. Cada trilho migra uma coleção a qualquer momento. Dessa forma, duas coleções normalmente são migradas em paralelo. Depois que a migração de uma coleção for concluída, a próxima coleção será automaticamente selecionada. Se tiver muitas coleções para migrar, crie várias tarefas de migração. Cada tarefa deve ter um escopo do número de coleções para ajudar que as migrações sejam mais eficientes.
Quantos bancos de dados e coleções posso migrar em uma única migração?
Não há limites para o número de bancos de dados e coleções que podem ser incluídos em uma única migração. No entanto, as coleções selecionadas são divididas em lotes de 50 ao criar as tarefas de migração no Serviço de Migração de Banco de Dados do Azure. Para grandes quantidades de coleções, você verá várias tarefas de migração na lista de migrações.
Como devo planejar a ordem e a quantidade de coleções a serem migradas?
Ao selecionar várias coleções para migrar, a ordem em que as coleções são migradas não é configurável. Se você deseja controlar a ordem de migração, migre as coleções em lotes menores com base na sequência desejada. Para obter o melhor desempenho, evite combinar coleções maiores com coleções menores no mesmo lote.
Como devo configurar meu Azure Cosmos DB for MongoDB com base em vCore e os firewalls do MongoDB para evitar problemas de conectividade?
Adicione exceções de firewall à conta de destino do Azure Cosmos DB for MongoDB com base em vCore para aceitar conexões de datacenters globais do Azure. Para obter mais informações, consulte Configuração de firewall no Azure Cosmos DB.
Como devo configurar meus firewalls do servidor de origem para evitar problemas de conectividade?
Configure a instância de origem do MongoDB para permitir conexões de datacenters globais do Azure. Para obter mais informações, consulte Intervalo de endereços IP no Azure.
Aviso
A extensão não é compatível com instâncias de origem ou de destino habilitadas para o ponto de extremidade privado do MongoDB. A extensão não dá suporte ao runtime de integração auto-hospedada do Serviço de Migração de Banco de Dados do Azure.
Os trabalhos de migração são executados localmente no meu computador?
O banco de dados, as coleções e os índices são criados diretamente usando comandos do cliente local do Azure Data Studio. Essa funcionalidade requer a conectividade do cliente que executa o Azure Data Studio com os ambientes de origem e de destino.
As tarefas de migração de dados são executadas no Serviço de Migração de Banco de Dados do Azure. O serviço de migração é uma instância de serviço do Azure que orquestra e executa atividades de movimentação de dados. Depois que as tarefas de migração de dados forem criadas, não será necessário estar conectado aos ambientes de origem e destino.
Quantas migrações posso executar simultaneamente?
Não há limites para o número de criações simultâneas de migrações.
Posso renomear bancos de dados e coleções durante a migração?
A extensão não dá suporte à renomeação de banco de dados e coleções durante a migração.
Posso migrar as coleções por meio de várias iterações de migração?
É possível criar vários trabalhos de migração, cada um com um número limitado de coleções. Essa abordagem é uma prática recomendada para otimizar a velocidade das migrações.
O que está incluído em um relatório de avaliação?
A parte inicial do relatório tem os principais detalhes da execução da avaliação, incluindo um resumo do ambiente de origem do MongoDB. Os detalhes incluem a versão de origem do MongoDB, o tipo de licença e o tipo de instância. Ele também contém uma lista dos bancos de dados e coleções avaliados, com os respectivos resumos de avaliação e de preparação para migração.
As descobertas são agrupadas nas categorias Crítico, Aviso e Informativo. Essas categorias ajudam a priorizar as descobertas de acordo com sua importância.
As verificações de avaliação incluem:
| Descrição | |
|---|---|
| Opcões de coleção | Descobertas relacionadas às configurações de coleção incompatíveis. Os exemplos incluem séries temporais e ordenações. |
| Recursos | Descobertas relacionadas a comandos de banco de dados incompatíveis, sintaxe de consulta ou operadores, incluindo consultas de pipeline de agregação. Na coluna de detalhes extras, você poderá ver com que frequência o recurso específico estava sendo usado no ponto de extremidade de origem. |
| Limites e cotas | Descobertas relacionadas a cotas e limites específicos do Azure Cosmos DB for MongoDB com base em vCore. |
| Índices | Descobertas relacionadas aos tipos de índice ou propriedades incompatíveis do MongoDB. |
| Chaves de fragmentação | Descobertas relacionadas a configurações de chave de fragmentação não compatíveis. |
Que tipo de logs a extensão cria?
A extensão armazena erros, avisos e outros logs de diagnóstico no diretório de log padrão:
- Windows -
C:\Users\<username>\.dmamongo\logs\ - Linux –
~/.dmamongo/logs - macOS –
/Users/<username>/.dmamongo/logs
Observação
Um arquivo de log separado é criado para cada dia. Por padrão, a extensão armazena os últimos sete arquivos de log.