Introduzione a Microsoft Power BI Embedded

Power BI Embedded è un servizio di Azure che consente agli sviluppatori di applicazioni di aggiungere report interattivi di Power BI alle proprie applicazioni. Power BI Embedded interagisce con le applicazioni esistenti senza che sia necessario riprogettarle o modificare la modalità di accesso da parte degli utenti.

Il provisioning delle risorse di Microsoft Power BI Embedded viene effettuato tramite le API di Azure Resource Manager. In questo caso, la risorsa di cui si effettua il provisioning è una Raccolta di aree di lavoro di Power BI.

Creare una raccolta di aree di lavoro

Una Raccolta di aree di lavoro è la risorsa di primo livello di Azure e un contenitore per il contenuto che verrà incorporato nell'applicazione. Una Raccolta di aree di lavoro può essere creata in due modi:

  • Uso manuale del portale di Azure
  • Uso delle API di Azure Resource Manager a livello di codice

Di seguito è descritta la procedura per compilare una Raccolta di aree di lavoro tramite il portale di Azure.

  1. Aprire il portale di Azureed eseguire l'accesso: http://portal.azure.com.
  2. Fare clic su + Nuovo nel pannello in alto.

  3. In Dati e analisi fare clic su Power BI Embedded.
  4. Nel pannello della Raccolta di aree di lavoro immettere le informazioni necessarie. Per Prezzi, vedere Prezzi di Power BI Embedded.

  5. Fare clic su Create.

Il provisioning della Raccolta di aree di lavoro richiederà alcuni istanti. Al termine verrà visualizzato il pannello della Raccolta di aree di lavoro.

Questo pannello di creazione contiene le informazioni necessarie per chiamare le API che creano le aree di lavoro e vi distribuiscono il contenuto.

Visualizzare le chiavi di accesso dell'API Power BI

Le chiavi di accessosono tra le informazioni più importanti necessarie per chiamare le API REST Power BI. Vengono usate per generare i token delle app che servono per autenticare le richieste delle API. Per visualizzare le chiavi di accesso fare clic su Chiavi di accesso nel pannello Impostazioni. Per altre informazioni sui token delle app, vedere Autenticazione e autorizzazione con Power BI Embedded.

Come si noterà, sono disponibili due chiavi.

Copiarle e archiviarle in modo sicuro nell'applicazione. È molto importante gestire queste chiavi come una password, perché forniscono l'accesso a tutto il contenuto della Raccolta di aree di lavoro.

Anche se sono disponibili due chiavi, è necessaria una sola chiave alla volta. La seconda chiave viene fornita per consentire di rigenerare periodicamente le chiavi senza interrompere l'accesso al servizio.

Dopo aver creato un'istanza di Power BI per l'applicazione e le chiavi di accesso, è possibile importare un report nell'app in uso. Prima di apprendere come importare un report, la sezione successiva descrive come creare set di dati e report di Power BI da incorporare in un'app.

Utilizzo di aree di lavoro

Dopo aver creato la raccolta di aree di lavoro, è necessario creare un'area di lavoro che dovrà contenere i report e i set di dati. Per creare un'area di lavoro, usare l'API REST di pubblicazione area di lavoro.

Creare set di dati e report di Power BI da incorporare in un'app usando Power BI Desktop

Dopo avere creato un'istanza di Power BI per l'applicazione e le chiavi di accesso, è necessario creare i set di dati e i report di Power BI da incorporare. I set di dati e i report possono essere creati con Power BI Desktop. È possibile scaricare Power BI Desktop gratuitamente. In alternativa, per iniziare rapidamente, è possibile scaricare l' esempio Retail Analysis PBIX.

Nota

Per altre informazioni sull'uso di Power BI Desktop, vedere Introduzione a Power BI Desktop.

Power BI Desktop consente di connettersi all'origine dati importando una copia dei dati in Power BI Desktop o tramite la connessione diretta all'origine dati con DirectQuery.

Di seguito sono spiegate le differenze tra l'importazione e la modalità DirectQuery.

Importa DirectQuery
Tabelle, colonne, e dati vengono importati o copiati in Power BI Desktop. Mentre si usano le visualizzazioni, Power BI Desktop esegue query su una copia dei dati. Per visualizzare le eventuali modifiche apportate ai dati sottostanti, è necessario aggiornare o importare di nuovo un set di dati completo e aggiornato. Solo tabelle e colonne vengono importate o copiate in Power BI Desktop. Mentre si usano le visualizzazioni, Power BI Desktop esegue query sull'origine dati sottostante, quindi vengono sempre visualizzati dati aggiornati.

Per altre informazioni sulla connessione a un'origine dati, vedere Connettersi a un'origine dati.

Dopo aver salvato il lavoro in Power BI Desktopviene creato un file PBIX. Questo file contiene il report. Se si importano dati, il PBIX include il set di dati completo, mentre se si usa DirectQuery, il PBIX contiene solo uno schema del set di dati. Distribuire a livello di codice il PBIX nell'area di lavoro con l' API di importazione di Power BI.

Nota

Power BI Embedded include altre API per modificare il server e il database a cui punta il set di dati e impostare le credenziali dell'account del servizio che saranno usate dal set di dati per la connessione al database. Vedere Post SetAllConnections (POST di SetAllConnections) e Patch Gateway Datasource (PATCH dell'origine dati del gateway).

Creare set di dati e report di Power BI usando le API

Set di dati

È possibile creare set di dati all'interno di Power BI Embedded usando l'API REST ed effettuare poi il push dei dati nel set di dati. In questo modo è possibile usare i dati senza Power BI Desktop. Per altre informazioni, vedere Post Datasets (Pubblica set di dati).

Report

È possibile creare un report da un set di dati direttamente nell'applicazione usando l'API JavaScript. Per altre informazioni, vedere Create a new report from a dataset in Power BI Embedded (Creare un nuovo report da un set di dati in Power BI Embedded).

Vedere anche

Esempio introduttivo
Autenticazione e autorizzazione con Power BI Embedded
Embed a report (Incorporare un report)
Create a new report from a dataset in Power BI Embedded (Creare un nuovo report da un set di dati in Power BI Embedded) Save reports (Salvare report)
Power BI Desktop
Esempio per incorporare JavaScript
Altre domande? Contattare la community di Power BI