Il mirroring in Microsoft Fabric offre un'esperienza senza ETL per integrare i dati di Azure Cosmos DB esistenti con il resto dei dati in Fabric. Usare i suggerimenti in questo articolo per risolvere i problemi che si potrebbero riscontrare quando si crea un database con mirroring per Azure Cosmos DB in Fabric.
Importante
Il mirroring per Azure Cosmos DB attualmente è disponibile in anteprima. I carichi di lavoro di produzione non sono supportati durante l'anteprima. Attualmente sono supportati solo gli account Azure Cosmos DB for NoSQL.
Ecco un elenco dei problemi comuni e delle opportune operazioni di risoluzione dei problemi da eseguire se il mirroring di un database di Azure Cosmos DB in Microsoft Fabric non funziona come previsto.
Durante il caricamento dei database il mirroring non riesce generando un errore "SQLAPIendpoint". Come si risolve questo errore?
Questo errore in genere segnala che la chiave dell'account Azure Cosmos DB non è più valida per la connessione selezionata. Dopo aver aggiornato le credenziali di connessione con una chiave dell'account valida, configurare il mirroring.
Fabric non è in grado di configurare il mirroring, generando un errore che segnala che l'account Azure Cosmos DB non dispone di backup continuo. Come si risolve questo errore?
Abilitare il backup continuo per l'account di Azure Cosmos DB. Per altre informazioni, si veda Creare un account Azure Cosmos DB con backup continuo o eseguire la migrazione di un account Azure Cosmos DB esistente al backup continuo.
Dopo aver abilitato la funzionalità di backup continuo, tornare all’impostazione del mirroring di Fabric e continuare con i passaggi rimanenti.
Come fare per sapere se l'account Azure Cosmos DB ha abilitato il backup continuo?
Se si utilizza il portale di Azure, è possibile verificare se la funzionalità di backup continuo è abilitata individuando l'opzione Ripristino temporizzato nel menu delle risorse per l'account Azure Cosmos DB. Se questa opzione non è disponibile, significa che l'account non ha abilitato il backup continuo oppure che l'account sta eseguendo la migrazione al backup continuo.
L'abilitazione del backup continuo nell'account Azure Cosmos DB provoca diversi errori. È comunque possibile configurare il mirroring di Fabric?
No, il backup continuo deve essere abilitato per gli account di Azure Cosmos DB destinati a essere un'origine di mirroring.
Se viene generato un messaggio di errore quando si abilita il backup continuo per un account di Azure Cosmos DB, l'account potrebbe avere limitazioni che bloccano la funzionalità. Ad esempio, se l'archivio analitico è stato eliminato in precedenza per l'account, l'account non potrà supportare il backup continuo. In questo scenario, l'unica opzione che resta consiste nell'usare un nuovo account Azure Cosmos DB per il mirroring.
Perché la replica non funziona e viene visualizzato "errore interno del server" quando si seleziona "Monitorare la replica"?
La replica potrebbe funzionare e si potrebbe osservare un errore temporaneo se Azure Cosmos DB limita le richieste da Fabric. Inoltre, potrebbe esserci una limitazione del mirroring con Azure Cosmos DB che provoca questo problema. Per altre informazioni, si veda Limiti per il mirroring in Azure Cosmos DB.
Aggiornare il portale di Fabric e verificare se il problema si risolve automaticamente. Inoltre, è possibile arrestare e avviare la replica. Se nessuna di queste opzioni funziona, aprire un ticket di supporto.
Come è possibile assicurarsi che Fabric stia replicando i dati da Azure Cosmos DB?
Prima di tutto, seguire la procedura generale di risoluzione dei problemi per i database con mirroring di Fabric. Per ulteriori informazioni, vedere Risoluzione dei problemi.
Nella maggior parte dei casi, l'opzione Monitoraggio della replica può fornire altri dettagli che indicano se i dati vengono replicati correttamente in Fabric. Un’operazione comune per la risoluzione dei problemi consiste nel verificare se l'ora dell'ultimo aggiornamento è recente. Se l'ora non è recente, come passaggio successivo arrestare e poi riavviare la replica. Si noti che l'"ora dell'ultimo aggiornamento" viene aggiornata solo se il database di origine ha subito modifiche dopo l'ora annotata per la replica. Se il database di origine non ha subito aggiornamenti, cancellazioni o inserimenti, l'ora dell'ultimo aggiornamento non viene aggiornata.
Il riquadro "Monitoraggio della replica" comprende tabelle senza righe replicate dopo un periodo di tempo significativo. La replica è bloccata?
La replica probabilmente è bloccata. Per prima cosa, arrestare e riavviare la replica. Se questo passaggio non funziona, aprire un ticket di supporto.
Perché non si riesce trovare tabelle nell'endpoint di analisi SQL?
Per prima cosa, aggiornare prima gli schemi e il nodo dbo per verificare se le tabelle sono pronte. Le tabelle vengono caricate automaticamente una volta pronte. Se dopo un periodo di tempo significativo non ci sono tabelle pronte, usare il riquadro Monitoraggio della replica per verificare se si sono verificati errori di replica.
Perché le tabelle del warehouse di destinazione comprendono solo la colonna "_rid" dopo la replica?
Per prima cosa, aggiornare prima gli schemi e il nodo dbo per verificare se le tabelle sono pronte. Le tabelle vengono caricate automaticamente una volta pronte. Se dopo un periodo di tempo significativo non ci sono colonne pronte, usare il riquadro Monitoraggio della replica per verificare se si sono verificati errori di replica.
Sono stati aggiunti nuovi elementi a un contenitore nel database di Azure Cosmos DB. Questi elementi non sono compresi nei risultati delle query sugli endpoint di analisi SQL. Come fare per sapere se la replica sta funzionando?
L'opzione Monitoraggio della replica può fornire altri dettagli che indicano se i dati vengono replicati correttamente in Fabric. Un’operazione comune per la risoluzione dei problemi consiste nel verificare se l'ora dell'ultimo aggiornamento è recente. Se l'ora non è recente, come passaggio successivo arrestare e poi riavviare la replica. Se l'ora è recente, tentare nuovamente la query. In alcuni casi, può verificarsi un ritardo tra l'inserimento dei dati in Azure Cosmos DB, la replica e la disponibilità in Fabric.
Se i dati non sono ancora disponibili, usare Lakehouse per creare un collegamento rapido ed eseguire una query Spark da un notebook. Spark visualizza sempre i dati più recenti. Se i dati sono disponibili in Spark ma non in Analisi SQL, aprire un ticket di supporto.
Se i dati non sono disponibili nemmeno in Spark, potrebbe essersi verificato un problema imprevisto con latenza di replica. Attendere un po' di tempo e riprovare a eseguire la replica. Se i problemi persistono, aprire un ticket di supporto.
Perché viene visualizzato un messaggio "Il testo JSON non è formattato correttamente". Messaggio di errore Carattere inatteso"" nella posizione" durante l'esecuzione di query T-SQL sull'endpoint di analisi SQL?
Il data warehouse non è in grado di gestire colonne di stringa JSON con dimensioni superiori a 8 KB. I dati annidati rappresentati come stringa JSON nelle tabelle dell'endpoint di analisi SQL o del warehouse in genere possono causare un aumento delle dimensioni della colonna oltre i 8 KB. Monitorare i livelli di annidamento e la quantità di dati se si riceve questo messaggio di errore. Per altre informazioni, vedere Limitazioni del data warehouse.
Perché viene visualizzato un errore "Nome colonna non valido" nel riquadro "Monitoraggio della replica"?
Il mirroring non supporta contenitori che contengono elementi con nomi di proprietà contenenti spazi vuoti o caratteri jolly. Questa limitazione provoca l'esito negativo del mirroring per quello specifico contenitore. Altri contenitori all'interno degli stessi database possono comunque eseguire il mirroring correttamente. Per altre informazioni, vedere limitazioni di replica.