Visualizzare i dati di Azure Cosmos DB usando Power BI
SI APPLICA A: 
NoSQL
Questo articolo descrive i passaggi necessari per connettere i dati dell'account Azure Cosmos DB a Power BI Desktop.
È possibile connettersi ad Azure Cosmos DB da Power BI Desktop usando una delle opzioni seguenti:
Usare Collegamento ad Azure Synapse per creare report di Power BI senza alcun impatto sulle prestazioni o sui costi per i carichi di lavoro transazionali e senza pipeline ETL.
È possibile usare DirectQuery o la modalità Importa. Con DirectQuery, è possibile creare dashboard/report usando dati in tempo reale dagli account Azure Cosmos DB, senza importare o copiare i dati in Power BI.
Connettere Power BI Desktop all'account Azure Cosmos DB con il connettore Azure Cosmos DB per Power BI. Questa opzione è disponibile solo in modalità Importa e utilizzerà le UR allocate per i carichi di lavoro transazionali.
Nota
I report creati in Power BI Desktop possono essere pubblicati in PowerBI.com. Non è possibile estrarre direttamente da PowerBI.com dati di Azure Cosmos DB.
Prerequisiti
Prima di seguire le istruzioni di questa esercitazione su Power BI, verificare di avere accesso alle risorse seguenti:
Creare un account di database Azure Cosmos DB e aggiungere dati ai contenitori di Azure Cosmos DB.
Per condividere i report in PowerBI.com, è necessario avere un account in PowerBI.com. Per altre informazioni su Power BI e su Power BI Pro, visitare il sito https://powerbi.microsoft.com/pricing.
Attività iniziali
Compilazione di report BI con Collegamento ad Azure Synapse
È possibile abilitare Collegamento ad Azure Synapse nei contenitori di Azure Cosmos DB esistenti e creare report BI su questi dati in pochi clic usando il portale di Azure Cosmos DB. Power BI si connetterà ad Azure Cosmos DB usando la modalità Direct Query, consentendo di eseguire query sui dati di Azure Cosmos DB in tempo reale, senza influire sui carichi di lavoro transazionali.
Per creare un report o un dashboard di Power BI:
Accedere al portale di Azure e passare all'account Azure Cosmos DB.
Nella sezione Integrazioni aprire il riquadro Power BI e selezionare Introduzione.
Nota
Attualmente, questa opzione è disponibile solo per gli account API per NoSQL. È possibile creare viste T-SQL direttamente nei pool SQL serverless di Synapse e creare dashboard BI per Azure Cosmos DB for MongoDB. Per altre informazioni, vedere "Usare Power BI e il pool Synapse SQL serverless per analizzare i dati di Azure Cosmos DB con Synapse".
Nella scheda Abilita Collegamento ad Azure Synapse è possibile abilitare Collegamento a Synapse nell'account dalla sezione Abilita Collegamento ad Azure Synapse per questo account. Se Collegamento a Synapse è già abilitato per l'account, questa scheda non verrà visualizzata. Questo passaggio è un prerequisito per iniziare ad abilitare Collegamento a Synapse nei contenitori.
Nota
L'abilitazione del Collegamento ad Azure Synapse ha implicazioni in termini di costi. Per altri dettagli, vedere la sezione Prezzi di Collegamento ad Azure Synapse.
Nella sezione Abilita Collegamento ad Azure Synapse per i contenitori, quindi scegliere i contenitori necessari per abilitare Collegamento a Synapse.
Se è già stato abilitato Collegamento a Synapse in alcuni contenitori, verrà visualizzata la casella di controllo accanto al nome del contenitore selezionato. Facoltativamente, è possibile deselezionarli in base ai dati da visualizzare in Power BI.
Se Collegamento a Synapse non è abilitato, è possibile abilitare questa opzione nei contenitori esistenti.
Se l'abilitazione di Collegamento a Synapse è in corso in uno dei contenitori, i dati di tale contenitore non verranno inclusi. Tornare a questa scheda in un secondo momento e importare i dati quando i contenitori sono abilitati.
A seconda della quantità di dati nei contenitori, l'abilitazione del Collegamento a Synapse può richiedere del tempo. Per altre informazioni, vedere l'articolo Abilitare Collegamento a Synapse nei contenitori esistenti.
È possibile controllare lo stato di avanzamento nel portale, come illustrato nella schermata seguente. I contenitori sono abilitati con Collegamento a Synapse quando lo stato di avanzamento raggiunge il 100%.
Nella scheda Selezionare l'area di lavoro scegliere l'area di lavoro di Azure Synapse Analytics e selezionare Avanti. Questo passaggio creerà automaticamente viste T-SQL in Synapse Analytics per i contenitori selezionati in precedenza. Per altre informazioni sulle viste T-SQL necessarie per connettere Azure Cosmos DB a Power BI, vedere Preparare le visualizzazioni.
Nota
Le proprietà dei contenitori di Azure Cosmos DB verranno rappresentate come colonne nelle viste T-SQL, inclusi i dati JSON annidati. Questa è una guida introduttiva per i dashboard BI. Queste viste saranno disponibili nell'area di lavoro/database di Synapse; è anche possibile usare queste stesse viste esattamente nell'area di lavoro Synapse per l'esplorazione dei dati, la data science, l'ingegneria dei dati e così via. Si noti che gli scenari avanzati possono richiedere visualizzazioni o ottimizzazioni più complesse di queste visualizzazioni, per ottenere prestazioni migliori. Per altre informazioni, vedere l'articolo procedure consigliate per Collegamento a Synapse quando si usano i pool SQL serverless Synapse.
È possibile scegliere un'area di lavoro esistente o crearne una nuova. Per selezionare un'area di lavoro esistente, specificare i dettagli di Sottoscrizione, Area di lavoro e Database. Il portale di Azure userà le credenziali di Microsoft Entra per connettersi automaticamente all'area di lavoro di Synapse e creare visualizzazioni T-SQL. Assicurarsi di disporre delle autorizzazioni di "Amministratore di Synapse" per questa area di lavoro.
Selezionare quindi Scarica .pbids per scaricare il file di origine dati di Power BI. Aprire il file scaricato. Contiene le informazioni di connessione necessarie e apre Power BI Desktop.
È ora possibile connettersi ai dati di Azure Cosmos DB da Power BI Desktop. Viene visualizzato un elenco di viste T-SQL corrispondenti ai dati in ogni contenitore.
Ad esempio, la schermata seguente mostra i dati della flotta di veicoli. È possibile caricare questi dati per ulteriori analisi o trasformarli prima del caricamento.
È ora possibile iniziare a creare il report usando i dati analitici di Azure Cosmos DB. Tutte le modifiche apportate ai dati verranno riflesse nel report non appena i dati vengono replicati nell'archivio analitico, il che in genere si verifica in un paio di minuti.
Compilazione di report BI con il connettore Power BI
Nota
La connessione ad Azure Cosmos DB con il connettore Power BI è attualmente supportata solo per gli account dell'API SQL di Azure Cosmos DB for NoSQL e dell'API per Gremlin.
Eseguire Power BI Desktop.
Le opzioni Recupera dati, Origini recenti e Apri altri report sono disponibili direttamente dalla schermata iniziale. Fare clic sulla X nell'angolo in alto a destra per chiudere la schermata. Apparirà la visualizzazione Report di Power BI Desktop.
Selezionare Home sulla barra multifunzione, quindi fare clic su Recupera dati. Verrà visualizzata la finestra Recupera dati .
Fare clic su Azure, selezionare Azure Cosmos DB (Beta) e quindi fare clic su Connetti.
Nella pagina Anteprima connettore fare clic su Continua. Viene visualizzata la finestra Azure Cosmos DB.
Specificare l'URL dell'endpoint dell'account Azure Cosmos DB da cui recuperare i dati, come illustrato di seguito, e quindi fare clic su OK. Per usare il proprio account, è possibile recuperare l'URL dalla casella URI nel pannello Chiavi del portale di Azure. Facoltativamente è possibile specificare il nome del database, il nome della raccolta oppure selezionare il database e la raccolta per identificare la provenienza dei dati.
Se ci si connette a questo endpoint per la prima volta, viene richiesta la chiave dell'account. Per il proprio account, recuperare la chiave dalla casella Chiave primaria nel pannello Chiavi di sola lettura del portale di Azure. Immettere la chiave appropriata e quindi fare clic su Connetti.
È consigliabile usare la chiave di sola lettura durante la creazione di report. In questo modo si impedisce un'inutile esposizione della chiave primaria a potenziali rischi di sicurezza. La chiave di sola lettura è disponibile nel pannello Chiavi del portale di Azure.
Una volta che l'account è connesso, viene visualizzato il riquadro Strumento di navigazione. Lo Strumento di navigazione mostra un elenco dei database che fanno parte dell'account.
Fare clic ed espandere il database da cui provengono i dati per il report. A questo punto, selezionare una raccolta che contiene i dati da recuperare.
Il riquadro di anteprima mostra un elenco di elementi Record . In Power BI un documento viene rappresentato come tipo di Record . In modo analogo, anche un blocco JSON annidato in un documento è un Record. Per visualizzare i documenti delle proprietà come colonne, fare clic sul pulsante grigio con 2 frecce in direzioni opposte che simboleggiano l'espansione del record. Si trova a destra del nome del contenitore, nello stesso riquadro di anteprima.
È possibile iniziare a creare i rapporti nella visualizzazione Report di Power BI Desktop per visualizzare dati. È possibile creare report trascinando i campi nell'area di disegno Report .
Esistono due modi per aggiornare i dati: procedura ad hoc e pianificata. Fare semplicemente clic su Aggiorna adesso per aggiornare i dati. Per altre informazioni sull'opzione di aggiornamento pianificato, vedere la documentazione di Power BI.
Passaggi successivi
- Per altre informazioni su Power BI, vedere Introduzione a Power BI.
- Per altre informazioni su Azure Cosmos DB, vedere la pagina iniziale della documentazione di Azure Cosmos DB.