Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
Questo articolo descrive i file e le sottocartelle nella cartella Modello Semantico di un progetto di Microsoft Power BI Desktop. I file e le sottocartelle rappresentano qui un modello semantico di Power BI. A seconda del progetto, la cartella del modello semantico può includere:
- .pbi\
- Cartella DAXQueries\
- Cartella TMDLScripts\
- definizione\cartella3
- model.bim2
- diagramLayout.json
- .piattaforma
- definition.pbism1
1 - Questo file è obbligatorio.
2 - Questo file è necessario quando si salva usando il formato TMSL.
3 - Questo file è necessario quando si salva usando il formato TMDL.
Non tutte le cartelle del modello semantico del progetto includono tutti i file e le sottocartelle descritte qui.
File del modello semantico
.pbi\localSettings.json
Contiene le impostazioni del modello semantico che si applicano solo all'utente e al computer corrente. Deve essere incluso in gitIgnore o in altre esclusioni del controllo del codice sorgente. Per impostazione predefinita, Git ignora questo file.
Per ulteriori informazioni, vedere il documento dello schema localSettings.json.
.pbi\editorSettings.json
Contiene le impostazioni dell'editor di modelli semantici salvate nell'ambito della definizione del modello semantico da usare tra utenti e ambienti.
Per ulteriori informazioni, vedere il documento dello schema editorSettings.json.
.pbi\cache.abf
Un file di backup di Analysis Services (ABF) contenente una copia memorizzata nella cache locale del modello e dei dati quando è stata modificata per l'ultima volta. Deve essere incluso in gitIgnore o in altre esclusioni del controllo del codice sorgente. Per impostazione predefinita, Git ignora questo file.
Power BI Desktop può aprire un progetto senza un file cache.abf. In tal caso, apre il report connesso a un modello con l'intera definizione ma senza dati. Se esiste un file cache.abf, Power BI Desktop carica i dati e sovrascrive la definizione del modello con i metadati del modello semantico nel progetto.
.pbi\unappliedChanges.json
Power BI Desktop consente di salvare le modifiche apportate nell'editor Trasform Data (Power Query) senza prima applicare tali modifiche al modello di dati.
Quando si seleziona Applica dopo, le modifiche non applicate vengono salvate nel file unappliedChanges.json. Quando le modifiche in sospeso si trovano nel file unappliedChanges, Power BI Desktop richiede l'applicazione o l'eliminazione di tali modifiche in sospeso:
Se si seleziona Applica modifiche, Power BI Desktop sovrascrive le query nei metadati del modello semantico con le query di unappliedChanges.json. Se sono state modificate query all'esterno di Power BI Desktop ed è presente un file di unappliedChanges.json precedente, le modifiche andranno perse e sostituite dalle query in unappliedChanges.json quando vengono applicate tali modifiche.
Il file unappliedChanges.json viene automaticamente incorporato nella definizione del modello semantico e salvato in Git per impostazione predefinita. In questo modo è possibile eseguire il commit del lavoro in corso nel ramo di sviluppo, fungendo da backup e rendendolo accessibile ad altri membri del team. Tuttavia, è possibile escludere questo file dal rilevamento di Git, impedendo al lavoro delle query non completate di influire su altri sviluppatori.
Per ulteriori informazioni, vedere il documento dello schema unappliedChanges.json.
definition.pbism
Contiene la definizione complessiva di un modello semantico e delle impostazioni principali.
Questo file specifica anche i formati di definizione del modello semantico supportati tramite la proprietà 'version'.
| Versione | Formati supportati |
|---|---|
| 1.0 | La definizione del modello semantico deve essere archiviata come TMSL nel file model.bim. |
| 4.0 o versione successiva | La definizione del modello semantico può essere archiviata come TMSL (file model.bim) o TMDL (\cartella definizione). |
Per ulteriori informazioni, vedere il documento dello schema definition.pbism.
model.bim
Questo file è disponibile solo se il progetto di Power BI viene salvato usando il formato TMSL. Contiene una definizione dell'oggetto Database per il modello del progetto nel Tabular Model Scripting Language (TMSL).
definizione\ cartella
Questa cartella è disponibile solo se il progetto di Power BI viene salvato usando il formato TMDL. Sostituisce il file model.bim.
Questa cartella contiene una definizione di oggetto del database TMDL (Tabular Model Definition Language) del modello di progetto.
diagramLayout.json
Contiene i metadati del diagramma che definiscono la struttura del modello semantico associato al report. Non è possibile modificare il file esternamente.
piattaforma
File della piattaforma fabric che contiene le proprietà essenziali per stabilire e mantenere la connessione tra gli elementi di Fabric e di Git.
Per ulteriori informazioni, vedere Integrazione di Git per i file di sistema generati automaticamente.
Cartella DAXQueries\
Contiene un file per ogni scheda delle query della vista DAX salvata come [Tab name].dax file DAX.
.pbi\daxQueries.json
Contiene impostazioni dell'editor della vista query DAX, come defaultTab o ordine di tabulazione.
Cartella TMDLScripts\
Contiene un file per ogni scheda dello script di visualizzazione TMDL salvata come [Tab name].tmdl file TMDL.
.pbi\tmdlscripts.json
Contiene le impostazioni dell'editor di visualizzazione TMDL come defaultTab o ordine delle schede.
Formato TMDL
Con l'obiettivo di offrire un controllo del codice sorgente e un'esperienza di co-sviluppo migliori, è possibile salvare i file di progetto di Power BI (PBIP) tramite TMDL (Tabular Model Definition Language) come formato di file del modello semantico.
A differenza del linguaggio Tabular Model Scripting Language (TMSL), TMDL è stato progettato da zero per essere intuitivo, semplificandone non solo la leggibilità, ma anche la modifica in qualsiasi editor di testo. Ciò rappresenta un miglioramento sostanziale per il controllo del codice sorgente e le esperienze di sviluppo collaborativo.
Anziché un file JSON di grandi dimensioni, come ad esempio TMSL, TMDL ha una struttura di cartelle con file separati per ogni tabella, prospettiva, ruolo e cultura. In questo modo è più semplice lavorare con altri utenti e comprendere la struttura del modello semantico semplicemente esaminando la cartella e i file. In definitiva, questo comporta un'ottima esperienza di controllo del codice sorgente e di co-sviluppo quando si gestiscono i git diff e i conflitti di unione.
Ulteriori informazioni su TMDL sono disponibili qui.
Apportare modifiche esterne ai file TMDL
È possibile modificare i file TMDL in Visual Studio Code o in un altro strumento esterno mentre il progetto rimane aperto in Power BI Desktop. Per un'esperienza di modifica TMDL migliore, installare l'estensione TMDL per Visual Studio Code.
Prima di modificare i file esternamente, salvare eventuali modifiche in Power BI Desktop. Aprire la cartella PBIP in VS Code, passare alla cartella del modello definition semantico e salvare le modifiche TMDL. Power BI Desktop rileva le modifiche salvate e visualizza il banner Applica modifiche esterne. Selezionare Applica modifiche esterne per ricaricare il modello semantico senza chiudere e riaprire il progetto.
Se Power BI Desktop ha modifiche non salvate, avvisa che l'applicazione delle modifiche esterne le sovrascriverà. Per il flusso di lavoro completo e le limitazioni, vedere Modificare i file PBIP all'esterno di Power BI Desktop.
Per le operazioni di scrittura supportate all'esterno di Power BI Desktop, vedere Creazione di modelli.
Errori TMDL
Se una modifica TMDL non è valida, Power BI Desktop visualizza un errore quando si applicano le modifiche esterne o si apre il progetto. L'errore identifica il percorso da correggere prima che Power BI Desktop possa caricare il modello semantico aggiornato:
