Arbeiten mit der TMDL-Ansicht

Mit der TMDL-Ansicht in Power BI Desktop und Power BI-Dienst können Sie Mithilfe eines modernen Code-Editors und einer tabellarischen Modelldefinitionssprache (TMDL) Änderungen an semantischen Modellobjekten erstellen, ändern und anwenden. Es verbessert die Entwicklungseffizienz und bietet vollständige Sichtbarkeit und Kontrolle über semantische Modellmetadaten.

Die TMDL-Ansicht bietet eine alternative Oberfläche zur semantischen Modellierung mithilfe von Code anstelle einer grafischen Benutzeroberfläche wie der Modellansicht.

Die TMDL-Ansicht bietet die folgenden Vorteile:

• Verbesserte Entwicklungseffizienz mit einem umfangreichen Code-Editor, der Suchen und Ersetzen, Tastenkombinationen, Bearbeitung mehrerer Zeilen und vieles mehr umfasst.
• Erhöhen Sie die Wiederverwendbarkeit, indem Sie TMDL-Skripts einfach skripten, freigeben und zwischen semantischen Modellentwicklern wiederverwenden. Verwenden Sie beispielsweise eine zentrale SharePoint-Website, um wiederverwendbare semantische Modellobjekte wie Kalendertabellen oder Zeitintelligenzberechnungsgruppen einfach freizugeben.
• Mehr Kontrolle und Transparenz durch Anzeigen aller semantischen Modellobjekte und -eigenschaften und das Zulassen von Änderungen an Elementen, die in der Power BI Benutzeroberfläche nicht verfügbar sind, z. B. IsAvailableInMDX oder DetailRowsDefinition.

Skript für TMDL

Wählen Sie in Power BI Desktop das TMDL-Ansichtssymbol auf der linken Seite des Fensters aus, wie in der folgenden Abbildung dargestellt.

Wählen Sie im Power BI-Dienst- oder Fabric Portalarbeitsbereich die TMDL-Ansicht (Vorschau) aus.

Wenn sich die TMDL-Ansicht öffnet, ist der Codeeditor anfangs leer. Sie können jedes semantische Modellobjekt wie eine Tabelle, ein Measure oder eine Spalte skripten, indem Sie die Objekte aus dem Datenbereich auswählen und auf den Code-Editor ziehen:

Wenn Sie die TMDL-Ansicht verwenden und das Objekt aus dem Datenbereich ziehen, skriptt Power BI die gesamten Objektmetadaten in die aktuelle Registerkarte als TMDL oder öffnet eine neue Registerkarte, wenn die aktuelle Registerkarte nicht leer ist, als createOrReplace TMDL-Skript der ausgewählten Objekte, wie in der folgenden Abbildung dargestellt:

Alternativ können Sie in der Datenansicht mit der rechten Maustaste auf ein Objekt klicken und Skript TMDL auswählen, um eine neue Registerkarte oder die Zwischenablage zu öffnen, wie in der folgenden Abbildung dargestellt:

Code-Editor

Nachdem Sie ein Semantikmodellobjekt geskriptet oder ein TMDL-Skript in den Code-Editor eingefügt haben, können Sie die umfassenden Features der Code-Umgebung nutzen, die im Code-Editor der TMDL-Ansicht enthalten sind. Mit den Code-Erlebnisfunktionen können Sie entweder die Modellmetadaten erkunden oder Änderungen vornehmen, die später auf das semantische Modell angewendet werden können.

Semantische Hervorhebung

Die semantische Hervorhebung ist in den Code-Editor integriert, wodurch die Lesbarkeit verbessert wird, indem Teile des Codes je nach Bedeutung in verschiedenen Farben hervorgehoben werden. Eine solche Farbcodierung erleichtert das Verständnis der Struktur und Funktionalität Ihres TMDL-Codes, wie in der folgenden Abbildung dargestellt.

Sie können auch Abschnitte Ihres TMDL-Skripts erweitern oder reduzieren, wie in der folgenden Abbildung dargestellt:

AutoVervollständigen

Das AutoVervollständigen-Feature ist in den Code-Editor integriert und bietet während des Tippens intelligente Vorschläge. AutoVervollständigen kann Ihren Workflow beschleunigen, die Wahrscheinlichkeit von Fehlern verringern und Ihnen helfen, Ihre Codeoptionen zu verstehen, indem es dynamisch mögliche Werte oder Eigenschaften unter Berücksichtigung der Cursorposition vorschlägt.

Sie können die AutoVervollständigen-Funktion auch an einem beliebigen Ort auslösen, indem Sie STRG+LEERTASTE drücken.

QuickInfos

Die Kontext-QuickInfo wird angezeigt, wenn der Mauszeiger über ein Element fährt, und enthält Informationen zu den einzelnen TMDL-Objekten oder -Eigenschaften.

Codeaktionen

Wenn sich der Cursor auf einer Zickzacklinie oder auf ausgewähltem Text befindet, zeigt die TMDL-Ansicht eine Glühbirne an, die die verfügbaren Code-Aktionen angibt, z. B. das Generieren von Herkunftstags oder das Korrigieren von Eigenschaftennamen.

Codeformatierung

Formatieren Sie den TMDL-Code, indem Sie UMSCHALT+ALT+F drücken oder auf die Option "Format" im Menüband klicken.

Sie können markierten Text auch mithilfe der Option "Auswahl formatieren" im Kontextmenü formatieren.

Fehlerdiagnose

Die integrierte Fehlerdiagnose des Code-Editors hilft Ihnen, Probleme zu erkennen und zu beheben, indem SIE TMDL-Sprachfehler im Code-Editor mit detaillierten Meldungen hervorheben, die Anleitungen zum Beheben dieser Fehler liefern. Darüber hinaus ist eine Fehlerzusammenfassung im Problembereich verfügbar, sodass eine einfache Navigation zur Fehlerposition im Code-Editor möglich ist, wie in der folgenden Abbildung dargestellt.

Anwenden von Änderungen auf das Semantikmodell

Wenn Sie bereit sind, können Sie die Schaltfläche Anwenden auswählen, um das TMDL-Skript auf das semantische Modell anzuwenden und Ihre TMDL-Codeänderungen auszuführen.

Bei erfolgreicher Ausführung wird eine Benachrichtigung angezeigt, und Ihre Modelländerungen werden auf das semantische Modell angewendet.

Im Falle eines Fehlers wird eine Fehlerbenachrichtigung angezeigt, um anzuzeigen, dass Ihre Modellierungsänderungen nicht auf das semantische Modell angewendet wurden. Sie können weitere Informationen zum Fehler anzeigen, indem Sie in der Benachrichtigung den Link "Details anzeigen " auswählen, der dann den Ausgabebereich erweitert und Fehlerdetails anzeigt.

Vorschau von Änderungen am Semantikmodell

Mit der TMDL-Ansicht können Sie Skriptänderungen in der Vorschau anzeigen, indem Sie eine Vorschau des semantischen Modells vor und nach der Skriptausführung anzeigen, die als TMDL-Code-Diff angezeigt wird. Die Vorschau von Skriptänderungen ist besonders hilfreich beim Kopieren von Skripts aus anderen Quellen, sodass Sie deren Auswirkungen bewerten können, bevor Sie sie mit Ihrem semantischen Modell ausführen.

Wenn Sie die Schaltfläche "Vorschau " auswählen, wird vor und nach dem Ausführen des TMDL-Skripts auf der geöffneten Registerkarte ein TMDL-Diff des Semantikmodells angezeigt.

Im rechten Bereich wird ein nebeneinander angeordnetes Fenster angezeigt, wie in der folgenden Abbildung dargestellt.

Rote und grüne Kästchen markieren die Änderungen, wobei rote Kästchen entfernte oder geänderte Zeilen und grüne neue Zeilen anzeigen.

Die Vorschau ist schreibgeschützt, aber Sie können Ihr Skript weiterhin bearbeiten. Um die Vorschau nach Änderungen zu aktualisieren, wählen Sie die Schaltfläche " Vorschau aktualisieren " aus, wie im Banner in der folgenden Abbildung dargestellt.

Es gibt eine Symbolleiste in der oberen rechten Ecke des Vorschaubildschirms, die die Navigation aller Code-Differenzen ermöglicht, sodass Sie zwischen Inline oder Parallel-Diff umschalten, unveränderbare Bereiche ein- oder ausblenden und die Ansicht der Vorschau schließen können.

Beim Erstellen einer Vorschau von Änderungen am semantischen Modell gibt es einige Überlegungen zu beachten.

• Die TMDL-Ansicht setzt die Ansichtskonfigurationen bei jeder Vorschauausführung auf die Grundeinstellungen zurück.
• Eine Vorschau wird nur mit einer gültigen TMDL-Änderung ausgeführt. Ungültige TMDL-Skripts führen keine Vorschau aus, und im Ausgabebereich wird ein Fehler angezeigt.

TMDL-Skriptregisterkarten

In der TMDL-Ansicht können Sie mehrere Skriptregisterkarten gleichzeitig geöffnet haben, die umbenannt oder entfernt werden können.

In den Bereichen "Probleme " und "Ausgabe " werden Fehler und Meldungen angezeigt, die für die derzeit ausgewählte und angezeigte Skriptregisterkarte spezifisch sind. Wenn Sie zu einer anderen TMDL-Skriptregisterkarte wechseln, werden beide Bereiche mit Informationen aktualisiert, die für die ausgewählte und aktuell angezeigte Registerkarte spezifisch sind.

Sie können die Schaltfläche " Löschen " auswählen, um die Nachrichten im Ausgabebereich zu leeren.

Nachrichten werden nur für jede Power BI Desktop-Sitzung aufbewahrt, sodass beim Neustart von Power BI Desktop alle Ausgabemeldungen für alle Skriptregisterkarten gelöscht werden.

In der TMDL-Ansicht in Power BI Desktop speichert die Berichtsdatei den Inhalt der Registerkarten der TMDL-Ansicht, sodass Sie beim nächsten Öffnen der Power BI Desktop-Berichtsdatei dort weitermachen können, wo Sie aufgehört haben. Beim Speichern in einem Power BI-Projekt (PBIP) wird jede Skriptregisterkarte als TMDL-Datei im Ordner \TMDLScripts gespeichert, wie in der folgenden Abbildung dargestellt.

In der TMDL-Ansicht im Web werden Skriptregisterkarten und Skriptinhalte nicht gespeichert. Sie werden verworfen, wenn das semantische Modell oder die Browsersitzung geschlossen wird.

Aufforderung zur Aktualisierung der Kompatibilitätsebene

Die Kompatibilitätsebene eines Power BI-Semantikmodells bestimmt die Features, auf die zugegriffen werden kann. Mit der TMDL-Ansicht können Sie beliebige Analysis Services-Objekte oder -Eigenschaften hinzufügen, auch wenn es auf der aktuellen Kompatibilitätsebene nicht verfügbar ist. Beim Anwenden einer Änderung, die ein Upgrade auf Kompatibilitätsebene erfordert, stellt die TMDL-Ansicht eine Eingabeaufforderung bereit, die angibt, welches Objekt oder welche Objekte das Upgrade erfordern.

Objektumbenennung mit der TMDL-Ansicht

Um ein Objekt in der TMDL-Ansicht umzubenennen, ist es erforderlich, das übergeordnete Objekt zu skripten. Das Umbenennen einer Spalte erfordert beispielsweise das Skripten der Tabelle, während das Umbenennen einer Tabelle das Skripting des gesamten Semantikmodells erfordert. Weitere Informationen zur Tabellenobjektmodellhierarchie im folgenden Dokument: Tabellarische Objektmodellhierarchie.

Mit der TMDL-Ansicht können Massenumbenennungen mithilfe einfacher Such- und Ersetzungsmuster effizient durchgeführt werden. Sie können beispielsweise alle Tabellenspalten in Kleinbuchstaben umbenennen, indem Sie die folgenden Schritte ausführen.

Öffnen Sie die TMDL-Ansicht, skripten Sie die Tabelle, die Sie ändern möchten.

Drücken Sie STRG+F, um das Dialogfeld "Suchen und Ersetzen" zu öffnen, stellen Sie sicher, dass die Option "Regulärer Ausdruck" aktiviert ist.

Geben Sie die folgenden Muster in die Felder "Suchen und Ersetzen" ein, und wählen Sie "Alle ersetzen" aus.

Führen Sie Ihr TMDL-Skript aus, um alle Tabellenspalten sofort in Kleinbuchstaben umzubenennen:

Beachten Sie, dass sich der Spaltenname von der sourceColumn-Eigenschaft unterscheidet.

Die Synchronisierung zwischen der Semantikmodelltabelle und der Power Query-Abfrage basiert auf "sourceColumn", wobei Namen unabhängig bleiben. Wenn Sie den Power Query-Editor öffnen, werden die Spaltennamen angezeigt, die mit dem SourceColumn übereinstimmen, und nicht den Spaltennamen des Modells. Darüber hinaus wird ein Umbenennungsschritt in der Abfrage durch das Umbenennen einer Spalte auf der Benutzeroberfläche nur dann automatisch hinzugefügt, wenn sourceColumn und Spaltenname identisch sind.

TMDL-Ansicht und Power BI-Projekt

Wenn Sie Ihre Arbeit als Power BI-Projekt (PBIP) speichern, erhalten Sie Zugriff auf Die Metadaten der semantischen Modelldefinition als TMDL-Dateien, die eine nützliche Quellcodeverwaltung und co-Entwicklungserfahrung bieten und gleichzeitig Änderungen am semantischen Modell außerhalb von Power BI Desktop vornehmen können. Wenn Sie jedoch die TMDL-Dateien innerhalb der PBIP ändern, müssen Sie Power BI Desktop neu starten, um diese Änderungen neu zu laden. Im Gegensatz dazu folgt die TMDL-Ansicht einem skriptbasierten mentalen Modell, sodass Sie Änderungen effizient direkt auf das semantische Modell anwenden können, das Sie in Power BI Desktop mit TMDL bearbeiten, unabhängig davon, ob das Dateiformat PBIX oder PBIP ist.

Sie können beide Erfahrungen nahtlos integrieren. Beispielsweise können Sie die TMDL-Definition in PBIP für schnelle Änderungen aktualisieren, ohne Power BI Desktop zu starten, und die TMDL-Ansicht verwenden, wenn Power BI Desktop bereits geöffnet ist, um eine Reihe von Änderungen am semantischen Modell mithilfe von TMDL effizient zu implementieren. Beide Ansätze bieten eine umfassende und konsistente Erfahrung bei der TMDL-Codierung.

TMDL-Ansicht in Power BI-Dienst (Vorschau)

Verwenden Sie die TMDL-Ansicht im Web, um Änderungen an Ihren veröffentlichten Semantikmodellen zu skripten, zu ändern und anzuwenden. Die TMDL-Ansicht im Web bietet die gleiche Erfahrung wie Power BI Desktop mit wenigen Ausnahmen.

Häufige Anwendungsfälle für die TMDL-Ansicht

Szenario: Ich muss eine Semantikmodelltabelle mit der vollständigen Definition wiederverwenden oder freigeben, einschließlich Spalten, Power Query-Ausdruck und Sortierung nach Konfiguration und anderen in einem anderen semantischen Modell.

Lösung: Öffnen Sie das semantische Modell mit der Tabelle, skripten Sie es mithilfe der TMDL-Ansicht. Kopieren Sie das Skript in das andere Power BI Desktop-Fenster, öffnen Sie die Registerkarte "TMDL-Ansicht", und wenden Sie das Skript an.

Szenario: Ich habe alle meine Tabellen mit den Präfixen "dim_" oder "fact_" benannt. Ich möchte diese Präfixe entfernen, ohne jede der mehr als 100 Tabellen manuell zu aktualisieren.

Lösung: Öffnen Sie die TMDL-Ansicht, skripten Sie das Semantikmodell, suchen Sie nach dem Präfix (reguläre Ausdrücke werden unterstützt), und ersetzen Sie sie durch einen leeren Text.

Szenario: Ich muss eine Perspektive in meinem Semantikmodell erstellen, um das personalisierte visuelle Feature zu verwenden. Ich kann sie jedoch nicht mithilfe der grafischen Benutzeroberfläche von Power BI Desktop erstellen oder bearbeiten.

Lösung: Öffnen Sie die TMDL-Ansicht, erstellen Sie eine neue leere Registerkarte (oder verwenden Sie das Skript aus einer vorhandenen Perspektive), und erstellen oder bearbeiten Sie dann die Perspektive mithilfe von TMDL. Diese Methode gilt auch für andere Semantikmodellmetadaten, die keine grafische Benutzeroberfläche aufweisen, z. B. Übersetzungen, Detailzeilenausdrücke und andere.

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

Szenario: Ich muss den Power Query-Ausdruck meiner Tabelle ändern, ohne eine Aktualisierung auszulösen.

Lösung: Skriptieren Sie die Tabelle, ändern Sie den Power Query-Ausdruck, und wenden Sie die Änderungen an. Die TMDL-Ansicht erfordert keine Aktualisierung Ihrer Daten.

Szenario: Ich muss den Speichermodus meiner Tabelle von DirectQuery auf Import und in die andere Richtung umstellen.

Lösung: Führen Sie die Tabelle aus, aktualisieren Sie den Partitionsmodus, und wenden Sie Änderungen an.

Szenario: Ich muss meine Semantikmodelldefinition sichern, bevor ich erhebliche Änderungen vornehme, und bei Bedarf einfach auf eine vorherige Definition zurückgreifen können.

Lösung: Skripten Sie das semantische Modell oder bestimmte Teile, die Sie sichern möchten, nehmen Sie Ihre Änderungen in anderen Ansichten vor, und kehren Sie ggf. zur TMDL-Ansicht zurück, um die vorherigen Metadaten wiederherzustellen, indem Sie das gespeicherte Skript ausführen.

Überlegungen und Einschränkungen

• Sie können die TMDL-Ansicht verwenden, um jedes Objekt oder jede Eigenschaft innerhalb eines semantischen Modells zu bearbeiten. Unvollständige oder falsche Änderungen können jedoch zu unerwartetem Verhalten führen. Weitere Anleitungen zu diesen Vorgängen finden Sie im Artikel zur Modellerstellung.
• Die Befehlspalette zeigt einige Befehle an, die derzeit nicht unterstützt werden.
• Das Einrichten der anfänglichen Git-Integration aus dem Arbeitsbereich enthält keine TMDL-Ansichtsskripts, die im veröffentlichten Semantikmodell gespeichert wurden. Weitere Informationen finden Sie im Fabric Git-Integrationsartikel .

Verwandte Inhalte

In den folgenden Artikeln werden weitere Informationen zu TMDL und deren Verwendung beschrieben.

• Erste Schritte mit TMDL
• Tabellarische Modelldefinitionssprache (TMDL)
• Power BI Desktop-Projekte (Vorschau)
• Power BI Desktop-Projektsemantikmodellordner