Lavorare con la visualizzazione TMDL

La visualizzazione TMDL in Power BI Desktop e servizio Power BI consente di creare script, modificare e applicare modifiche agli oggetti modello semantico usando un editor di codice moderno e TMDL (Tabular Model Definition Language). Migliora l'efficienza dello sviluppo e offre visibilità completa e controllo sui metadati del modello semantico.

La visualizzazione TMDL offre un'esperienza alternativa alla modellazione semantica usando il codice anziché un'interfaccia utente grafica, ad esempio visualizzazione modello.

La visualizzazione TMDL offre i vantaggi seguenti:

• Migliorata efficienza di sviluppo con un editor di codice avanzato che include funzionalità di ricerca e sostituzione, tasti di scelta rapida, modifiche su più righe e altro ancora.
• aumentare facilmente la riutilizzabilità tramite lo scripting, la condivisione e il riutilizzo di script TMDL tra sviluppatori di modelli semantici. Ad esempio, usare un sito di SharePoint centralizzato per condividere facilmente oggetti modello semantici riutilizzabili, ad esempio tabelle di calendario o gruppi di calcolo di intelligenza temporale.
• Maggiore controllo e trasparenza visualizzando tutti gli oggetti e le proprietà del modello semantico e consentendo modifiche agli elementi non disponibili nell'interfaccia utente Power BI, ad esempio IsAvailableInMDX o DetailRowsDefinition.

Eseguire lo script in TMDL

In Power BI Desktop, selezionare l'icona visualizzazione TMDL che si trova sul lato sinistro della finestra, come illustrato nell'immagine seguente.

Nell'area di lavoro del servizio Power BI o del portale di Fabric, selezionare Visualizzazione TMDL (Anteprima).

Quando la visualizzazione TMDL apre l'editor di codice è inizialmente vuoto. È possibile creare script per qualsiasi oggetto modello semantico, ad esempio una tabella, una misura o una colonna, selezionando gli oggetti dal riquadro dati e trascinandoli nell'editor di codice:

Quando si utilizza la visualizzazione TMDL e si trascina l'oggetto dal riquadro Dati, Power BI inserisce i metadati completi dell'oggetto nella scheda corrente sotto forma di TMDL, oppure apre una nuova scheda se quella corrente non è vuota, come uno script TMDL createOrReplace degli oggetti selezionati, come mostrato nell'immagine seguente:

In alternativa, è possibile fare clic con il pulsante destro del mouse su un oggetto nella visualizzazione Dati e selezionare Script TMDL in una nuova scheda o negli Appunti, come illustrato nell'immagine seguente:

Editor di codice

Dopo aver creato uno script di un oggetto modello semantico o incollato uno script TMDL nell'editor di codice, è possibile usare le funzionalità complete dell'esperienza di codice offerte dall'editor di codice della vista TMDL. Le funzionalità dell'esperienza del codice consentono di esplorare i metadati del modello o di apportare modifiche che possono essere applicate successivamente al modello semantico.

Evidenziazione semantica

L'evidenziazione semantica è integrata nell'editor di codice, che migliora la leggibilità applicando colori diversi alle parti del codice in base al significato. Tale codifica a colori semplifica la comprensione della struttura e delle funzionalità del codice TMDL, come illustrato nell'immagine seguente.

È anche possibile espandere o comprimere sezioni dello script TMDL, come illustrato nell'immagine seguente:

Completamento automatico

Il completamento automatico è integrato nell'editor di codice e offre suggerimenti intelligenti durante la digitazione. Il completamento automatico può velocizzare il flusso di lavoro, ridurre la probabilità di errori e aiutare a comprendere le opzioni del codice suggerendo dinamicamente valori o proprietà possibili prendendo in considerazione la posizione del cursore.

È anche possibile attivare la funzionalità di completamento automatico in qualsiasi posizione premendo CTRL+SPAZIO.

Suggerimenti

Il tooltip contestuale viene visualizzato al passaggio del mouse, fornendo informazioni su ogni oggetto o proprietà TMDL.

Screenshot di un tooltip di contesto visualizzato nell'editor di codice al passaggio del mouse, mostrando informazioni su un oggetto o una proprietà TMDL.

Azioni del codice

Quando il cursore si trova su un testo ondulato o selezionato, la visualizzazione TMDL visualizza un'icona a forma di lampadina che indica le azioni di codice disponibili, ad esempio la generazione di tag di derivazione o la correzione di errori di ortografia del nome della proprietà.

Formattazione del codice

Formattare il codice TMDL premendo MAIUSC + ALT + F oppure facendo clic sull'opzione Formato sulla barra multifunzione.

È possibile formattare il testo selezionato anche usando l'opzione "Formato selezione" nel menu di scelta rapida.

Diagnostica degli errori

La diagnostica degli errori predefinita dell'editor di codice consente di identificare e risolvere i problemi evidenziando gli errori del linguaggio TMDL nell'editor di codice, con messaggi dettagliati che forniscono indicazioni sulla risoluzione dei problemi. Inoltre, nel riquadro problemi è disponibile un riepilogo degli errori, che consente di spostarsi facilmente nella posizione di errore nell'editor di codice, come illustrato nell'immagine seguente.

Applicare modifiche al modello semantico

Quando sei pronto, puoi selezionare il pulsante Applica per effettuare lo script TMDL sul modello semantico e applicare le modifiche al codice TMDL.

In caso di esito positivo, viene visualizzata una notifica e la modifica della modellazione viene applicata al modello semantico.

In caso di errore, viene visualizzata una notifica di errore per indicare che le modifiche di modellazione non sono state applicate al modello semantico. Per visualizzare altre informazioni sull'errore, selezionare il collegamento Mostra dettagli nella notifica, che espande quindi il riquadro di output e visualizza i dettagli dell'errore.

Anteprima delle modifiche apportate al modello semantico

La visualizzazione TMDL consente di visualizzare in anteprima le modifiche dello script visualizzando un'anteprima del modello semantico prima e dopo l'esecuzione dello script, visualizzata come diff del codice TMDL. L'anteprima delle modifiche dello script è particolarmente utile quando si copiano script da altre origini, consentendo di valutarne l'impatto prima di eseguirli sul modello semantico.

Selezionando il pulsante Anteprima viene visualizzata una differenza TMDL del modello semantico prima e dopo l'esecuzione dello script TMDL nella scheda aperta.

Nel riquadro destro viene visualizzata una finestra affiancata, come illustrato nell'immagine seguente.

Le caselle rosse e verdi evidenziano le modifiche, con le caselle rosse indicate come linee rimosse o modificate e il verde che indica nuove linee.

L'anteprima è di sola lettura, ma è possibile continuare a modificare lo script. Per aggiornare l'anteprima dopo le modifiche, selezionare il pulsante Aggiorna anteprima , come illustrato nel banner nell'immagine seguente.

È presente una barra degli strumenti nell'angolo superiore destro della schermata di anteprima che consente di navigare tra tutte le differenze di codice, consentendo di passare tra diff inline o affiancata, visualizzare o nascondere le aree non modificate e chiudere la vista di anteprima.

Quando si visualizzano le modifiche apportate al modello semantico, tenere presenti alcune considerazioni:

• La visualizzazione TMDL reimposta le configurazioni di visualizzazione per impostazione predefinita in ogni esecuzione dell'anteprima.
• Un'anteprima funziona solo con una modifica TMDL valida. Gli script TMDL non validi non eseguono un'anteprima e viene visualizzato un errore nel riquadro Output.

Schede script TMDL

Nella visualizzazione TMDL è possibile avere più schede di script contemporaneamente, una delle quali può essere rinominata o rimossa.

I riquadri Problemi e Output visualizzano errori e messaggi specifici della scheda script attualmente selezionata e visualizzata. Il passaggio a un'altra scheda script TMDL aggiorna entrambi i riquadri con informazioni specifiche della scheda selezionata e attualmente visualizzata.

È possibile selezionare il pulsante cancella per svuotare i messaggi del riquadro Output.

I messaggi vengono mantenuti solo per ogni sessione di Power BI Desktop, quindi il riavvio di Power BI Desktop cancella tutti i messaggi di output per tutte le schede degli script.

Nella visualizzazione TMDL di Power BI Desktop, il file del report salva il contenuto delle schede della visualizzazione TMDL, così da poter riprendere da dove si era interrotto la prossima volta che si apre il file del report di Power BI Desktop. Quando si salva in un progetto Power BI (PBIP), ogni scheda di script viene salvata come file .tmdl nella cartella \TMDLScripts, come illustrato nell'immagine seguente.

Nella visualizzazione TMDL sul Web, le schede di script e il contenuto dello script non vengono mantenuti. Vengono eliminati quando il modello semantico o la sessione del browser viene chiusa.

Richiesta di aggiornamento a livello di compatibilità

Il livello di compatibilità di un modello semantico di Power BI determina le funzionalità accessibili. La vista TMDL consente di aggiungere qualsiasi oggetto o proprietà di Analysis Services, anche se non è disponibile a livello di compatibilità corrente. Quando si applica una modifica che richiede un aggiornamento del livello di compatibilità, la vista TMDL fornisce una richiesta che indica l'oggetto o gli oggetti che richiedono l'aggiornamento.

Ridenominazione degli oggetti con la visualizzazione TMDL

Per rinominare un oggetto all'interno della visualizzazione TMDL, è necessario realizzare uno script del suo elemento genitore. Ad esempio, la ridenominazione di una colonna richiede lo scripting della tabella, mentre la ridenominazione di una tabella richiede lo script dell'intero modello semantico. Altre informazioni sulla gerarchia del modello a oggetti tabulari sono disponibili nel documento seguente: Gerarchia del modello a oggetti tabulari.

Con la vista TMDL, la ridenominazione in blocco può essere eseguita in modo efficiente usando modelli di ricerca e sostituzione semplici. Ad esempio, è possibile rinominare tutte le colonne della tabella in lettere minuscole seguendo questa procedura.

Aprire la vista TMDL, creare uno script per la tabella che si intende modificare.

Premere CTRL+F per aprire la finestra di dialogo Trova e sostituisci, assicurarsi che l'opzione Espressione regolare sia abilitata.

Immettere i modelli seguenti nei campi trova e sostituisci e selezionare Sostituisci tutto.

Eseguire lo script TMDL per rinominare immediatamente tutte le colonne della tabella in lettere minuscole:

Si noti che il nome della colonna sarà diverso dalla proprietà sourceColumn.

La sincronizzazione tra la tabella del modello semantico e la query di Power Query si basa su sourceColumn, mantenendo i nomi indipendenti. Quando si apre l'editor di Power Query, verranno visualizzati i nomi di colonna corrispondenti a sourceColumn, anziché il nome della colonna del modello. Inoltre, la ridenominazione di una colonna nell'interfaccia utente non aggiungerà automaticamente un passaggio di ridenominazione alla query finché sourceColumn e il nome della colonna non sono identici.

Visualizzazione TMDL e progetto di Power BI

Quando si salva il lavoro come progetto di Power BI (PBIP), si ottiene l'accesso ai metadati di definizione del modello semantico come file TMDL , fornendo un'esperienza utile di controllo del codice sorgente e di co-sviluppo, consentendo allo stesso tempo di apportare modifiche al modello semantico all'esterno di Power BI Desktop. Tuttavia, se si modificano i file TMDL all'interno del PBIP, è necessario riavviare Power BI Desktop per ricaricare tali modifiche. Al contrario, la vista TMDL segue un modello mentale di scripting, consentendo di applicare in modo efficiente le modifiche direttamente al modello semantico da modificare in Power BI Desktop usando TMDL, indipendentemente dal fatto che il formato di file sia PBIX o PBIP.

È possibile integrare facilmente entrambe le esperienze. Ad esempio, è possibile aggiornare la definizione TMDL in PBIP per modifiche rapide senza avviare Power BI Desktop e usare la visualizzazione TMDL quando Power BI Desktop è già aperto per implementare in modo efficiente una serie di modifiche al modello semantico usando TMDL. Entrambi gli approcci offrono un'esperienza di codifica TMDL completa e coerente.

Visualizzazione TMDL in servizio Power BI (anteprima)

Usare la visualizzazione TMDL sul Web per creare script, modificare e applicare modifiche ai modelli semantici pubblicati. La visualizzazione TMDL sul Web offre la stessa esperienza di Power BI Desktop con alcune eccezioni.

Casi d'uso comuni per la visualizzazione TMDL

scenario: ho bisogno di riutilizzare o condividere una tabella del modello semantico con la definizione completa, incluse le colonne, l'espressione di Power Query, la configurazione di ordinamento, e altri elementi in un altro modello semantico.

Soluzione: Aprire il modello semantico con la tabella, crearne uno script usando la vista TMDL. Copiare lo script nell'altra finestra di Power BI Desktop, aprire la scheda Visualizzazione TMDL e applicare lo script.

Scenario : Ho denominato tutte le tabelle con i prefissi "dim_" o "fact_". Vorrei rimuovere questi prefissi senza aggiornare manualmente ognuna delle oltre 100 tabelle.

Soluzione: Aprire la vista TMDL, creare lo script del modello semantico, cercare il prefisso (sono supportate espressioni regolari) e sostituirlo con un testo vuoto.

Scenario: Ho bisogno di creare una prospettiva nel mio modello semantico per utilizzare la funzionalità di oggetti visivi personalizzati . Tuttavia, non è possibile crearlo o modificarlo usando l'interfaccia grafica di Power BI Desktop.

Soluzione: Aprire la visualizzazione TMDL, creare una nuova scheda vuota (o usare lo script da una prospettiva esistente), quindi creare o modificare la prospettiva usando TMDL. Questo metodo si applica anche ad altri metadati del modello semantico che non dispongono di un'interfaccia grafica, ad esempio traduzioni, espressioni di riga di dettaglio e altre.

createOrReplace
      perspective SalesView
        perspectiveTable Sales
            perspectiveMeasure 'Sales Amount'
            perspectiveMeasure 'Sales Qty'
            perspectiveColumn Quantity
            perspectiveColumn 'Amount'

Scenario: Ho bisogno di modificare l'espressione di Power Query della mia tabella senza avviare un aggiornamento.

Soluzione: Creare script per la tabella, modificare l'espressione di Power Query e applicare le modifiche. La visualizzazione TMDL non richiede l'aggiornamento dei dati.

Scenario: Ho bisogno di cambiare la modalità di archiviazione della mia tabella da DirectQuery a Import e viceversa

Soluzione: Creare uno script per la tabella, aggiornare la modalità di partizione e applicare le modifiche.

Scenario: Ho bisogno di eseguire il backup della definizione del modello semantico prima di fare modifiche importanti e per ripristinare facilmente una definizione precedente, se necessario.

Soluzione: Creare uno script per il modello semantico o parti specifiche di cui eseguire il backup, apportare le modifiche in altre viste e, se necessario, tornare alla visualizzazione TMDL per ripristinare i metadati precedenti eseguendo lo script salvato.

Considerazioni e limitazioni

• È possibile usare la visualizzazione TMDL per modificare qualsiasi oggetto o proprietà all'interno di un modello semantico. Tuttavia, le modifiche incomplete o non corrette possono causare comportamenti imprevisti. Per altre indicazioni su queste operazioni, vedere l'articolo Creazione di modelli.
• Il riquadro comandi visualizza alcuni comandi attualmente non supportati.
• La configurazione iniziale dell'integrazione Git dall'area di lavoro non includerà gli script di visualizzazione TMDL salvati nel modello semantico pubblicato. Per saperne di più, consultare l'articolo sull'integrazione di Git in Fabric.

Contenuto correlato

Gli articoli seguenti descrivono altre informazioni su TMDL e sui relativi usi.

• Introduzione al TMDL
• Linguaggio di Definizione del Modello Tabulare (TMDL)
• progetti di Power BI Desktop (anteprima)
• cartella del modello semantico del progetto di Power BI Desktop