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 a perguntas frequentes sobre a extensão de migração.
Como faço para executar minha avaliação se a etapa "Executar validação" estiver falhando?
Consulte o erro exibido na extensão para ver por que a validação está falhando. Normalmente, o problema é uma incapacidade de se conectar ao ponto de extremidade do MongoDB. O problema também pode ser o usuário não ter privilégios suficientes no servidor conectado para executar a avaliação.
Para executar uma avaliação, o usuário conectado ao MongoDb deve ter readAnyDatabase e clusterMonitor funções atribuídas na instância de origem.
Use grantRolesToUser para configurar funções apropriadas para o usuário conectado no momento.
Como posso ver nomes de coleções e nomes de bancos de dados para avaliações na categoria "Compatibilidade de recursos"?
A avaliação usa o serverStatus comando para executar a avaliação de compatibilidade de recursos. Como esse comando não fornece os detalhes dos nomes do banco de dados ou da coleção, a extensão não consegue relatar os nomes dos recursos.
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 faço para 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 obter mais informações, consulte Mensagens de log do MongoDB.
Quando 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 estima o número de documentos em cada coleção a serem movidos da origem para o destino 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 clusterizadas. Assim, 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 quando o Azure Cosmos DB para MongoDB baseado em vCore oferece suporte a modos de exibição?
O Azure Cosmos DB para MongoDB baseado em vCore suporta a criação de novas vistas. No entanto, a extensão de migração não fornece suporte para migrar exibições existentes.
Depois que a migração for concluída, você sempre poderá recriar os modos de exibição.
Quanto armazenamento devo esperar usar na conta de destino após a migração?
O Azure Cosmos DB para MongoDB baseado em vCore não compacta dados no disco. Uma estimativa aproximada típica é dobrar o tamanho de armazenamento consumido pelas coleções na instância do MongoDB de origem para estimar o armazenamento na conta do Azure Cosmos DB para MongoDB baseada em vCore de destino.
Quais coleções e bancos de dados são ignorados ao migrar do MongoDB para o Azure Cosmos DB para MongoDB baseado em vCore?
Os seguintes bancos de dados e coleções são considerados internos para o MongoDB:
| Recurso | |
|---|---|
| Bases de dados | admin, local, system config |
| Collections | Qualquer coleção com prefixo system. |
Como os bancos de dados internos e as coleções não são necessários no Azure Cosmos DB para MongoDB baseado em vCore, a extensão não habilita a migração desses bancos de dados.
É possível migrar bases de dados e coleções cujos nomes começam com números?
Trata-se de um problema conhecido. A migração não suporta bancos de dados e coleções cujos nomes começam 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 trens para migração. Cada trem migra uma coleção a qualquer momento. Assim, duas coleções são normalmente migradas em paralelo. Quando a migração para uma coleção é concluída, a próxima coleção é retirada automaticamente. Se você tiver muitas coleções para migrar, crie várias tarefas de migração. Cada tarefa deve ter um número definido de coleções para ajudar a tornar as migrações 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?
Quando você seleciona 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 em um lote.
Como devo configurar meu Azure Cosmos DB baseado em vCore para firewalls MongoDB e MongoDB para evitar problemas de conectividade?
Adicione exceções de firewall à conta de destino do Azure Cosmos DB para MongoDB baseada em vCore para aceitar conexões de datacenters globais do Azure. Para obter mais informações, consulte Configuração do firewall do Azure Cosmos DB.
Como devo configurar meus firewalls do servidor de origem para evitar problemas de conectividade?
Configure a instância do MongoDB de origem para permitir conexões de datacenters globais do Azure. Para obter mais informações, consulte Intervalos de endereços IP globais do Azure.
Aviso
A extensão não suporta instâncias MongoDB de origem ou de destino habilitadas para Private Endpoint. A extensão não dá suporte ao tempo de execução de integração auto-hospedado do Serviço de Migração de Banco de Dados do Azure.
Os trabalhos de migração são executados localmente na minha máquina?
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 conectividade entre o 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 são criadas, não é necessário estar conectado aos ambientes de origem e de destino.
Quantas migrações posso executar simultaneamente?
Não há limites para o número de migrações que você pode criar simultaneamente.
Posso renomear bancos de dados e coleções durante a migração?
A extensão não suporta renomeação de banco de dados e coleção 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 num 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 MongoDB de origem. Os detalhes incluem a versão do MongoDB de origem, o tipo de licença e o tipo de instância. Esta parte contém igualmente uma lista das bases de dados e coleções avaliadas, com os respetivos resumos de avaliação e preparação para a migração.
Os resultados são agrupados em categorias Críticas, Advertentes e Informativas. Estas categorias ajudam-no a priorizar os resultados de acordo com a sua importância.
As verificações de avaliação incluem:
| Description | |
|---|---|
| Opções de Recolha | Constatações relacionadas às configurações de coleta sem suporte. Os exemplos incluem séries temporais e agrupamentos. |
| Funcionalidades | Descobertas relacionadas a comandos de banco de dados sem suporte, 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 quotas | Descobertas relacionadas ao Azure Cosmos DB baseado em vCore para cotas e limites específicos do MongoDB. |
| Índices | Descobertas relacionadas aos tipos ou propriedades de índice MongoDB sem suporte. |
| Teclas de estilhaços | Descobertas relacionadas a configurações de chave de estilhaço não suportadas. |
Que tipo de logs a extensão cria?
A extensão armazena erros, avisos e outros registos de diagnóstico no diretório de registo predefinido:
- Windows -
C:\Users\<username>\.dmamongo\logs\ - Linux -
~/.dmamongo/logs - macOS -
/Users/<username>/.dmamongo/logs
Nota
Um arquivo de log separado é criado para cada dia. Por padrão, a extensão armazena os últimos sete arquivos de log.