L'estensione della migrazione di Azure Cosmos DB for MongoDB consente di eseguire la migrazione dei carichi di lavoro MongoDB ad Azure Cosmos DB. Questo articolo presenta le risposte ad alcune domande comuni sull’estensione di migrazione.
Come eseguire la valutazione se il passaggio "Esegui convalida" ha esito negativo?
Fare riferimento all'errore visualizzato nell'estensione per vedere perché la convalida ha dato esito negativo. In genere, il problema è un'impossibilità di connettersi all'endpoint MongoDB. Il problema potrebbe anche essere l'utente che non dispone di privilegi sufficienti sul server connesso per eseguire la valutazione.
Per eseguire una valutazione, l'utente connesso a MongoDb deve avere i ruoli readAnyDatabase e clusterMonitor assegnati nell'istanza di origine.
Usare grantRolesToUser per configurare i ruoli appropriati per l'utente correntemente connesso.
Come vedere nomi di raccolta e nomi di database per le valutazioni nella categoria "Compatibilità delle funzionalità"?
La valutazione usa il comando serverStatus per eseguire la valutazione della compatibilità delle funzionalità. Poiché questo comando non fornisce i dettagli dei nomi di database o delle raccolte, non è possibile riportare i nomi delle risorse.
Eseguire di nuovo la valutazione specificando il percorso della cartella contenente i log del profiler MongoDB nel campo Percorso cartella log per informazioni più granulari sulla valutazione.
Come raccogliere messaggi di log?
È possibile individuare il file di log nel percorso seguente: /var/log/mongodb/mongodb.log. Se il file di log non viene trovato, controllare il percorso nel file di configurazione di MongoDB.
Per altre informazioni, vedere Messaggi di log di MongoDB.
Una volta avviata la migrazione, perché non è possibile visualizzare il numero esatto di documenti migrati e viene fornita una stima?
Per ridurre l'utilizzo delle risorse nell'origine durante la migrazione, l'estensione stima il numero di documenti in ogni raccolta da spostare dall'origine alla destinazione anziché recuperare il conteggio esatto.
Perché alcune raccolte sono mancanti o disabilitate nel passaggio di mapping della raccolta?
Azure Cosmos DB for MongoDB basato su vCore non supporta le raccolte di serie temporali o cluster. Di conseguenza, questi tipi di raccolte sono mancanti o disabilitati nel passaggio di mapping della raccolta.
Perché le visualizzazioni sono mancanti o disabilitate nel passaggio di mapping delle raccolte quando Azure Cosmos DB for MongoDB basato su vCore supporta le visualizzazioni?
Azure Cosmos DB for MongoDB basato su vCore supporta la creazione di nuove viste. Tuttavia, l'estensione per la migrazione non fornisce supporto per la migrazione di viste esistenti.
Al termine della migrazione, è sempre possibile ricreare le visualizzazioni.
Quanto spazio di archiviazione si prevede di usare nell'account di destinazione dopo la migrazione?
Azure Cosmos DB for MongoDB basato su vCore non comprime i dati su disco. Una stima approssimativa tipica consiste nel raddoppiare le dimensioni di archiviazione utilizzate dalle raccolte nell'istanza di MongoDB di origine per stimare lo spazio di archiviazione nell'account Azure Cosmos DB for MongoDB basato su vCore di destinazione.
Quali raccolte e database vengono ignorati durante la migrazione da MongoDB ad Azure Cosmos DB for MongoDB basato su vCore?
I database e le raccolte seguenti sono considerati interni per MongoDB:
| Conto risorse | |
|---|---|
| Database | admin, local, system config |
| Raccolte | Qualsiasi raccolta con prefisso system. |
Poiché i database e le raccolte interni non sono necessari in Azure Cosmos DB for MongoDB basato su vCore, l'estensione non abilita la migrazione di questi database.
È possibile eseguire la migrazione di database e raccolte i cui nomi iniziano con numeri?
Questo è un problema noto. La migrazione non supporta database e raccolte i cui nomi iniziano con numeri.
Se si selezionano più raccolte da migrare, viene eseguita la migrazione in parallelo?
Ogni attività di migrazione in Servizio Migrazione del database di Azure fornisce due training per la migrazione. Ogni training esegue la migrazione di una raccolta in qualsiasi momento. Di conseguenza, viene eseguita la migrazione in parallelo di due raccolte. Una volta completata la migrazione per una raccolta, viene selezionata automaticamente la raccolta successiva. Se sono presenti molte raccolte da migrare, creare più attività di migrazione. Ogni attività deve avere un numero limitato di raccolte per rendere le migrazioni più efficienti.
Quanti database e raccolte è possibile migrare in una singola attività di migrazione?
Non esistono limiti al numero di database e raccolte che possono essere inclusi in una singola migrazione. Tuttavia, le raccolte selezionate vengono suddivise in batch di 50 durante la creazione delle attività di migrazione in Servizio Migrazione del database di Azure. Per grandi quantità di raccolte, nell'elenco delle migrazioni vengono visualizzate più attività di migrazione.
Come pianificare l'ordine e la quantità di raccolte di cui eseguire la migrazione?
Quando si selezionano più raccolte da migrare, l'ordine in cui viene eseguita la migrazione delle raccolte non è configurabile. Se si vuole controllare l'ordine di migrazione, eseguire la migrazione delle raccolte in batch più piccoli in base alla sequenza desiderata. Per ottenere prestazioni ottimali, evitare di combinare raccolte di grandi dimensioni con raccolte più piccole in un batch.
Come configurare i firewall di Azure Cosmos DB for MongoDB basato su vCore e MongoDB per evitare problemi di connettività?
Aggiungere eccezioni del firewall all'account di destinazione di Azure Cosmos DB for MongoDB basato su vCore per accettare connessioni dai data center di Azure globali. Per altre informazioni, vedere Configurazione del firewall di Azure Cosmos DB.
Come configurare i firewall del server di origine per evitare problemi di connettività?
Configurare l'istanza di MongoDB di origine per consentire le connessioni dai data center globali di Azure. Per ulteriori informazioni, vedere Intervalli di indirizzi IP di Azure globali.
Avviso
L'estensione non supporta l'origine abilitata per l'endpoint privato o le istanze di MongoDB di destinazione. L'estensione non supporta il runtime di integrazione self-hosted del Servizio Migrazione del database di Azure.
I processi di migrazione vengono eseguiti localmente nel computer?
Il database, le raccolte e gli indici vengono creati direttamente usando i comandi del client di Azure Data Studio locale. Questa funzionalità richiede la connettività tra il client che esegue Azure Data Studio con gli ambienti di origine e di destinazione.
Le attività di migrazione dei dati vengono eseguite in Servizio Migrazione del database di Azure. Il servizio di migrazione è un'istanza del servizio di Azure che orchestra ed esegue attività di spostamento dei dati. Dopo aver creato le attività di migrazione dei dati, non è necessario essere connessi agli ambienti di origine e di destinazione.
Quante migrazioni è possibile eseguire contemporaneamente?
Non esistono limiti al numero di migrazioni che è possibile creare contemporaneamente.
È possibile rinominare database e raccolte durante la migrazione?
L'estensione non supporta la ridenominazione del database e della raccolta durante la migrazione.
È possibile eseguire la migrazione delle raccolte tramite più iterazioni di migrazione?
È possibile creare più processi di migrazione, ognuno con un numero limitato di raccolte. Questo approccio è una procedura consigliata per ottimizzare la velocità delle migrazioni.
Cosa è incluso in un report di valutazione?
La parte iniziale del report contiene i dettagli chiave dell'esecuzione della valutazione, incluso un riepilogo dell'ambiente MongoDB di origine in cui è stata eseguita la valutazione. I dettagli includono la versione di MongoDB di origine, il tipo di licenza e il tipo di istanza. Contiene anche un elenco dei database e delle raccolte valutati, con i rispettivi riepiloghi di valutazione e conformità alla migrazione.
I risultati sono raggruppati in categorie critiche, di avviso e informative. Queste categorie consentono di classificare in ordine di priorità i risultati in base alla loro importanza.
I controlli di valutazione includono:
| Descrizione | |
|---|---|
| Opzioni di raccolta | Risultati correlati alle impostazioni di raccolta non supportate. Gli esempi includono serie temporali e regole di confronto. |
| Funzionalità | Risultati correlati a comandi di database non supportati, sintassi di query o operatori, incluse le query della pipeline di aggregazione. Nella colonna dei dettagli aggiuntivi è possibile visualizzare la frequenza con cui è stata usata la funzionalità specifica nell'endpoint di origine. |
| Limiti e quote | Risultati correlati a quote e limiti specifici di Azure Cosmos DB for MongoDB basato su vCore. |
| Indici | Risultati correlati ai tipi o alle proprietà di indice MongoDB non supportati. |
| Chiavi di partizionamento | Risultati relativi alle configurazioni delle chiavi di partizionamento non supportate. |
Quale tipo di log crea l'estensione?
L'estensione contiene errori, avvisi e altri log di diagnostica nella directory di log predefinita:
- Windows -
C:\Users\<username>\.dmamongo\logs\ - Linux:
~/.dmamongo/logs - macOS:
/Users/<username>/.dmamongo/logs
Nota
Per ogni giorno viene creato un file di resoconto separato. Per impostazione predefinita, l'estensione archivia gli ultimi 7 file di resoconto.