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.
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. Come è possibile 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.
Come è possibile 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é la replica non funziona e viene visualizzato l'errore interno del server quando si seleziona "Monitor replication"?
Se si usa Entra ID per l'autenticazione, verificare che siano state aggiunte le autorizzazioni necessarie per il controllo degli accessi in base al ruolo. Per altre informazioni, vedere Limitazioni di sicurezza del mirroring di Azure Cosmos DB.
In caso contrario, 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. È anche possibile deselezionare e deselezionare nuovamente i contenitori interessati per arrestare e riavviare 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. Si noti che l'ora dell'ultimo aggiornamento viene aggiornata solo se il database di origine ha modifiche dopo l'ora annotata per la replica. Se il database di origine non ha aggiornamenti, elimina o inserisce , l'ora dell'ultimo aggiornamento non verrà aggiornata.
Il riquadro "Monitor replication" include tabelle senza righe replicate dopo un periodo di tempo significativo. La replica è bloccata?
La replica è probabilmente bloccata. Deselezionare il contenitore interessato e selezionare nuovamente per 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. Come è possibile 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 dell'endpoint di analisi SQL o del warehouse possono in genere causare l'aumento delle dimensioni della colonna a più di 8 KB. 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.
Il mirroring di Cosmos DB supporta i nomi di colonna con caratteri speciali?
Sì, i nomi di colonna con spazi vuoti o caratteri jolly come =, ;, {}, (), \n, \t sono supportati.