Usare i file di immagine e di mapping di OneLake nei report di Power BI

Si applica a:✅ Power BI Desktop e servizio Power BI

Archiviare i file di immagine e i file di mapping delle forme in Microsoft OneLake quando si vogliono usare i file autenticati nei report di Power BI. Power BI usa l'identità di Microsoft Entra di ogni visualizzatore di report per caricare i file OneLake. I file non richiedono l'accesso anonimo, ma ogni visualizzatore deve disporre dell'autorizzazione per leggerli.

Questo articolo illustra come caricare i file in un lakehouse, copiare un URL di file e usare l'URL in un report.

Prerequisites

  • Area di lavoro Microsoft Fabric in cui è possibile creare una lakehouse e caricare file.
  • Power BI Desktop o autorizzazione per modificare un report nel servizio Power BI.
  • Per configurare l'accesso al visualizzatore, un ruolo amministratore o membro dell'area di lavoro o assistenza di un utente con uno di questi ruoli.

Caricare immagini in OneLake

Una lakehouse fornisce un'area File per l'archiviazione di immagini e altri file non strutturati in OneLake.

  1. Crea una lakehouse nell'area di lavoro Fabric.
  2. Apri il lakehouse, quindi espandi Files in Esplora lakehouse.
  3. Aprire il menu di scelta rapida per File o una cartella e quindi selezionare Carica file>.
  4. Selezionare i file di immagine e quindi selezionare Carica.

È anche possibile caricare immagini con OneLake File Explorer. Trascina i file da una cartella locale nella cartella File del lakehouse in Esplora file di Windows.

Copiare l'URL del file OneLake

Copiare l'URL per ogni immagine da usare in un report.

  1. In Lakehouse Explorer individuare l'immagine in File.
  2. Aprire il menu di scelta rapida del file di immagine e quindi selezionare Proprietà.
  3. Nel riquadro Proprietà copiare il valore dell'URL .

L'URL usa il formato HTTPS di OneLake. Per esempio:

https://onelake.dfs.fabric.microsoft.com/<workspace-guid>/<item-guid>/Files/<path>/<file-name>

Per altre informazioni sui percorsi di OneLake, vedere sintassi di OneLake URI.

Aggiungere l'URL a un report

La modalità di aggiunta dell'URL dipende dal fatto che il report usi un'immagine o selezioni le immagini in base ai dati.

Immettere un URL nel riquadro formato

Utilizzare questo metodo quando un oggetto visivo visualizza un'immagine.

  1. Seleziona un elemento visivo che supporti un URL immagine, ad esempio un'immagine o una scheda.
  2. Nel riquadro Formato oggetto visivo aprire le impostazioni per l'immagine.
  3. Per l'origine dell'immagine, selezionare Immetti URL.
  4. Incollare l'URL del file OneLake.

La posizione e il nome delle impostazioni dell'immagine variano a seconda dell'elemento visivo. Per un esempio, vedi Creare un oggetto visivo di tipo immagine.

Usa una colonna URL dell'immagine

Usare una colonna quando ogni riga o categoria può visualizzare un'immagine diversa.

  1. Aggiungere gli URL del file OneLake a una colonna nei dati di origine.
  2. In Power BI Desktop aprire Vista tabella e selezionare la colonna.
  3. Nella scheda Strumenti colonna, imposta Categoria dati su URL immagine.
  4. Aggiungi la colonna a un oggetto visivo che supporta immagini dai dati.

Per altre informazioni, vedere Specificare categorie di dati in Power BI Desktop e Visualizzare immagini in una tabella, una matrice o un filtro dei dati.

Usa una misura URL immagine

Usare una misura DAX (Data Analysis Expressions) quando l'URL dell'immagine deve rispondere al contesto di filtro del report. L'esempio seguente restituisce un URL di file OneLake:

Image URL = "https://onelake.dfs.fabric.microsoft.com/<workspace-guid>/<item-guid>/Files/<path>/<file-name>"
  1. Creare una misura che restituisce l'URL del file OneLake.
  2. Selezionare la misura e quindi aprire la scheda Strumenti misura .
  3. Impostare Categoria dati su URL immagine.
  4. Aggiungere la misura a un oggetto visivo o usarla come campo per un'impostazione di immagine.

Per altre informazioni sulla creazione di misure, vedere Creare misure per l'analisi dei dati in Power BI Desktop.

Usa le immagini di OneLake negli oggetti visivi

È possibile usare gli URL delle immagini OneLake in questi scenari di report:

Potrebbero esserci altri scenari, perché gli elementi visivi continuano a supportare gli URL delle immagini. Controllare la documentazione relativa all'oggetto visivo che si vuole usare per verificare se accetta un URL di immagine.

Concedere ai visualizzatori di report l'accesso

Gli utenti che visualizzano il report possono vedere un'immagine di OneLake solo se dispongono dell'accesso al report e dell'autorizzazione di lettura per il file dell'immagine in OneLake. L'accesso al report o al modello semantico non concede automaticamente l'accesso al file.

Concedere a ogni visualizzatore l'autorizzazione lettura per l'elemento lakehouse. Quindi concedi l'autorizzazione di sicurezza di OneLake Lettura sulla cartella che contiene l'immagine. In alternativa, concedere l'autorizzazione ReadAll per l'elemento lakehouse per fornire l'accesso a tutto il contenuto in Tabelle e file. Seguire il principio dei privilegi minimi e concedere l'accesso solo alle cartelle necessarie ai visualizzatori.

Per informazioni dettagliate, vedere Modello di controllo degli accessi alla sicurezza di OneLake e Procedure consigliate per la sicurezza di OneLake.

Considerazioni

  • Power BI supporta GLI URL di immagini BMP, JPG, JPEG, GIF, PNG e SVG. Le immagini dei marcatori di Mappe di Azure richiedono file SVG.
  • Lo spostamento o la ridenominazione di un file ne modifica il percorso. Aggiornare l'URL nel report o nel modello semantico dopo una modifica.
  • Le immagini di grandi dimensioni possono aumentare il tempo necessario per eseguire il rendering di una pagina del report. Usare dimensioni dell'immagine e dimensioni del file appropriate per l'oggetto visivo.
  • Gli URL di OneLake richiedono l'autenticazione. I visualizzatori di report che non dispongono dell'autorizzazione per leggere un file non visualizzano l'immagine.
  • La pubblicazione sul Web e altri scenari di incorporamento anonimi non supportano gli URL di file OneLake perché questi scenari non possono eseguire l'autenticazione in OneLake.
  • Le pipeline di distribuzione non riscrivono gli URL delle immagini OneLake. Un report distribuito in una nuova fase continua a fare riferimento ai file nell'area di lavoro originale. Per fare riferimento alle immagini nell'ambiente di destinazione, utilizzare i parametri oppure aggiornare gli URL dopo la distribuzione.