Cartella del modello semantico del progetto di Power BI Desktop
Importante
Progetti di Power BI Desktop è attualmente in anteprima.
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:
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 il contenuto in model.bim.
.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 in model.bim con le query di unappliedChanges.json. Se sono state modificate query in model.bim all'esterno di Power BI Desktop ed è presente un file 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 di oggetto Database Tabular Model Scripting Language (TMSL) del modello di progetto.
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. Durante l'ANTEPRIMA, questo file non supporta la modifica esterna.
piattaforma Mail Luck!.
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.
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 conflitti relativi a differenze e unione git.
Ulteriori informazioni su TMDL sono disponibili qui.
Abilitare la funzionalità di anteprima del formato TMDL
Il salvataggio come progetto di Power BI con TMDL è attualmente in anteprima. Prima di usarlo, è necessario abilitarlo nelle funzionalità di anteprima:
Passare a File >Opzioni e impostazioni > Opzioni > Funzionalità di anteprima e selezionare la casella accanto a Archiviare modello semantico tramite formato TMDL.
Salvare come progetto usando TMDL
Con la funzionalità Anteprima TMDL abilitata, quando si salva un progetto, il modello semantico viene salvato come cartella TMDL denominata \definizione all'interno della cartella del modello semantico:
Ulteriori informazioni sulla struttura delle cartelle TMDL.
Convertire PBIP esistente in TMDL
Se si dispone già di un PBIP usando TMSL come formato di modello semantico, è possibile convertirlo in TMDL come indicato di seguito:
Aprire il PBIP in Power BI Desktop.
Verificare che la funzionalità di anteprima sia abilitata.
Salvare il progetto. Viene visualizzato un prompt che chiede di eseguire l'upgrade a TMDL.
Selezionare Aggiorna.
Importante
Dopo l'aggiornamento a TMDL, non è possibile tornare a TMSL. Se si ritiene di voler ripristinare TMSL, salvare prima una copia dei file PBIP.
Il file TMSL esistente (model.bim) viene sostituito con una cartella \definition contenente la rappresentazione TMDL del modello semantico.
Se si seleziona Mantieni il formato corrente, Desktop non chiederà nuovamente di eseguire l'upgrade.
Apportare modifiche esterne ai file TMDL
Per un'esperienza migliore di lettura e modifica dei file TMDL, installare l'estensione TMDL - Visual Studio Marketplace di Microsoft VS Code.
Aprire la cartella PBIP usando VS Code e passare alla cartella di definizione del modello semantico.
Power BI Desktop non è a conoscenza delle modifiche apportate ai file di progetto da altri strumenti. Pertanto, se si apportano modifiche per aprire file all'esterno di Power BI Desktop, è necessario riavviare per visualizzare tali modifiche in Power BI Desktop.
Vedere qui per le operazioni di scrittura supportate all'esterno di Power BI Desktop.
Errori TMDL
Se vengono apportate modifiche non valide ai file TMDL, Power BI Desktop genera un errore all'apertura, con il percorso dell'errore:
Considerazioni e limitazioni TMDL
Durante l'anteprima pubblica, Fabric Git Integration esporterà comunque il modello semantico usando TMSL per impostazione predefinita. Tuttavia, se il modello semantico viene importato in Fabric usando l'integrazione Git di Fabric con il formato TMDL, Fabric Git Integration userà il formato TMDL per esportare la definizione del modello semantico in Git in caso di modifiche del modello semantico nel servizio.
Importante
Se si importa il modello semantico usando qualsiasi altro metodo di importazione, come ad esempio Pubblicazione di Power BI Desktop, Fabric Git Integration tornerà al formato TMSL predefinito.