Il mirroring in Microsoft Fabric offre un'esperienza senza ETL senza interruzioni 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 potrebbero verificarsi quando si crea un database con mirroring per Azure Cosmos DB in Fabric.
Importante
Il mirroring per Azure Cosmos DB è attualmente in anteprima. I carichi di lavoro di produzione non sono supportati durante l'anteprima. Attualmente sono supportati solo gli account Azure Cosmos DB per NoSQL.
Ecco un elenco dei problemi comuni e dei passaggi di risoluzione dei problemi pertinenti da seguire se il mirroring di un database di Azure Cosmos DB in Microsoft Fabric non funziona come previsto.
Non è possibile visualizzare l'opzione per il mirroring nella pagina "Crea" o "Data Warehouse" del portale di Fabric. Ricerca per categorie abilitare il mirroring?
L'amministratore dell'organizzazione deve abilitare la funzionalità di mirroring per visualizzare l'opzione di mirroring nell'area di lavoro o nel tenant dell'infrastruttura. Per altre informazioni, vedere Abilitare il mirroring.
Il mirroring non riesce durante il caricamento dei database con un errore "SQLAPIendpoint". Come si risolve questo errore?
Questo errore indica in genere 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 di nuovo il mirroring.
Fabric non è in grado di configurare il mirroring con un errore che indica che l'account Azure Cosmos DB non dispone di backup continuo. Ricerca per categorie correggere l'errore?
Abilitare il backup continuo per l'account Azure Cosmos DB. Per altre informazioni, vedere 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 alla configurazione del mirroring dell'infrastruttura e continuare con i passaggi rimanenti.
Ricerca per categorie sapere se l'account Azure Cosmos DB ha abilitato il backup continuo?
Usando 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, l'account non ha il backup continuo abilitato o l'account esegue la migrazione al backup continuo.
L'abilitazione del backup continuo nell'account Azure Cosmos DB causa diversi errori. È comunque possibile configurare il mirroring dell'infrastruttura?
No, il backup continuo deve essere abilitato per gli account Azure Cosmos DB destinati a essere un'origine di mirroring.
Se si verifica un messaggio di errore quando si abilita il backup continuo per un account 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 può supportare il backup continuo. In questo scenario, l'unica opzione rimanente consiste nell'usare un nuovo account Azure Cosmos DB per il mirroring.
Perché si verificano errori di "capacità di valutazione" quando si seleziona "Crea un database di Azure Cosmos DB con mirroring"?
È necessario abilitare il mirroring per l'area di lavoro o il tenant. Per altre informazioni, vedere Abilitare il mirroring. Se si osservano errori persistenti, aprire un ticket di supporto.
Perché viene visualizzato l'errore interno del server quando si seleziona "Crea un database di Azure Cosmos DB con mirroring"?
È necessario abilitare il mirroring per l'area di lavoro o il tenant. Per altre informazioni, vedere Abilitare il mirroring. Se si osservano errori persistenti, aprire un ticket di supporto.
Perché la replica non funziona e viene visualizzato l'errore interno del server quando si seleziona "Monitor replication"?
La replica potrebbe funzionare e si osserva un errore temporaneo se Azure Cosmos DB limita le richieste da Fabric. Inoltre, potrebbe esserci una limitazione del mirroring con Azure Cosmos DB che causa questo problema. Per altre informazioni, vedere Limitazioni del mirroring di Azure Cosmos DB.
Aggiornare il portale di Fabric e determinare se il problema viene risolto 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 di risoluzione dei problemi generale per i database con mirroring di Fabric. Per altre informazioni, vedere Risoluzione dei problemi.
Nella maggior parte dei casi, l'opzione Monitoraggio replica può fornire altri dettagli che indicano se i dati vengono replicati correttamente in Fabric. Un passaggio comune per la risoluzione dei problemi consiste nel verificare se l'ora dell'ultimo aggiornamento è recente. Se l'ora non è recente, arrestare e quindi riavviare la replica come passaggio successivo.
Il riquadro "Monitor replication" include tabelle senza righe replicate dopo un periodo di tempo significativo. La replica è bloccata?
La replica è probabilmente bloccata. Arrestare e riavviare la replica come primo passaggio. Se questo passaggio non funziona, aprire un ticket di supporto.
Perché non è possibile trovare tabelle nell'endpoint di analisi SQL?
Aggiornare prima di tutto gli schemi e il nodo dbo per determinare se le tabelle sono pronte. Le tabelle vengono caricate automaticamente dopo che sono pronte. Se nessuna tabella è pronta dopo un periodo di tempo significativo, usare il riquadro Monitoraggio replica per determinare se si sono verificati errori di replica.
Perché le tabelle del warehouse di destinazione includono solo la colonna "_rid" dopo la replica?
Aggiornare prima di tutto gli schemi e il nodo dbo per determinare se le tabelle sono pronte. Le tabelle vengono caricate automaticamente dopo che sono pronte. Se più colonne non sono pronte dopo un periodo di tempo significativo, usare il riquadro Monitoraggio replica per determinare se si sono verificati errori di replica.
Sono stati aggiunti nuovi elementi a un contenitore nel database Azure Cosmos DB. Questi elementi non sono inclusi nei risultati delle query sugli endpoint di analisi SQL. Ricerca per categorie sapere se la replica funziona?
L'opzione Monitoraggio replica può fornire altri dettagli che indicano se i dati vengono replicati correttamente in Fabric. Un passaggio comune per la risoluzione dei problemi consiste nel verificare se l'ora dell'ultimo aggiornamento è recente. Se l'ora non è recente, arrestare e quindi riavviare la replica come passaggio successivo. Se l'ora è recente, tentare di nuovo la query. In alcuni casi, può verificarsi un ritardo tra l'inserimento dei dati in Azure Cosmos DB e la replica e la disponibilità in Fabric.
Se i dati non sono ancora disponibili, usare Lakehouse per creare un collegamento ed eseguire una query Spark da un notebook. Spark mostra 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 anche in Spark, potrebbe verificarsi un problema imprevisto con latenza di replica. Attendere un po' di tempo e riprovare 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 "" imprevisto "" 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 superiori a 8 KB. I dati annidati rappresentati come stringa JSON nelle tabelle di SQL Endpoint Warehouse possono in genere causare un aumento della colonna a più di 8 KB di dimensioni. Monitoraggio dei livelli di annidamento e della quantità di dati se viene visualizzato questo messaggio di errore. Per altre informazioni, vedere Limitazioni del data warehouse.
Perché viene visualizzato un errore "Nome colonna non valido" nel riquadro "Monitoraggio replica"?
Il mirroring non supporta contenitori che contengono elementi con nomi di proprietà contenenti spazi vuoti o caratteri jolly. Questa limitazione causa l'esito negativo del mirroring per il contenitore specifico. Altri contenitori all'interno degli stessi database possono comunque eseguire correttamente il mirroring. Per altre informazioni, vedere Limitazioni della replica.