TMSL-Referenz (Tabular Model Scripting Language)

Gilt für: SQL Server 2016 und höher Analysis Services Azure Analysis Services Power BI Premium

Tabular Model Scripting Language (TMSL) ist die Befehls- und Objektmodelldefinitionssyntax für tabellarische Datenmodelle mit Kompatibilitätsgrad 1200 oder höher. TMSL kommuniziert mit Analysis Services über das XMLA-Protokoll, wobei die XMLA.Execute Methode sowohl JSON-basierte Anweisungsskripts in TMSL als auch die herkömmlichen XML-basierten Skripts in Analysis Services Scripting Language (ASSL für XMLA) akzeptiert.

Wichtige Elemente von TMSL:

  • Tabellarische Metadaten, die auf tabellarischer Modellsemantik basieren.

    Ein tabellarisches Modell besteht aus Tabellen, Spalten und Beziehungen. Äquivalente Objektdefinitionen in TMSL sind jetzt , nicht überraschend, Tabellen, Spalten, Beziehungen usw. Eine neue Metadaten-Engine unterstützt diese Definitionen.

  • Objektdefinitionen sind als JSON und nicht als XML strukturiert.

    Mit Ausnahme der Formatierung der Nutzlast (in JSON oder XML) sind sowohl TMSL als auch ASSL funktionell gleichwertig, da sie Befehle und Metadaten für XMLA-Methoden bereitstellen, die für die Serverkommunikation und Datenübertragung verwendet werden.

Verwenden von TMSL

Die einfachste Möglichkeit zum Untersuchen von TMSL-Skripts ist die Verwendung der Befehle CREATE, ALTER, DELETE oder Process in SQL Server Management Studio (SSMS) in einem Modell, das Sie bereits kennen.

  1. Suchen Sie den Befehl, den Sie verwenden möchten: TMSL-Referenz – Befehle

  2. Überprüfen Sie den Objektdefinitionsverweis für objekte, die im Befehl verwendet werden: TMSL-Referenz – Objekte

  3. Wählen Sie eine Methode zum Ausführen des TMSL-Skripts aus:

Modelldefinitionsschema

Der folgende Screenshot zeigt eine abgekürzte Version des Schemas, reduziert, um die Hauptobjekte zu zeigen.

SSAS_TabularMetadata

Skriptsprachen in Analysis Services

Analysis Services unterstützt ASSL- und TMSL-Skriptsprachen. Nur tabellarische Modelle, die mit dem Kompatibilitätsgrad 1200 oder höher erstellt wurden, werden in TMS im JSON-Format beschrieben.

Analysis Services Scripting Language (ASSL für XMLA) war die erste Skriptsprache und ist weiterhin die einzige Skriptsprache für mehrdimensionale Modelle und tabellarische Modelle mit niedrigeren Kompatibilitätsgraden (1100 oder 1103). In ASSL werden tabellarische Modelle bei 110x mehrdimensional beschrieben, z. B. Cube (für ein Modell) und Measuregruppe (für eine Tabelle).

Hinweis

In [SQL Server Data Tools (SSDT) können Sie ein früheres tabellarisches Versionsmodell für die Verwendung von TMSL aktualisieren, indem Sie den CompatibilityLevel auf 1200 oder höher umschalten. Denken Sie daran, dass das Upgrade nicht rückgängig gemacht werden kann. Sichern Sie ihr Modell vor dem Upgrade, falls Sie die ursprüngliche Version später benötigen.

Die folgende Tabelle enthält die Skriptsprachenmatrix für Analysis Services Datenmodelle in verschiedenen Versionen mit bestimmten Kompatibilitätsgraden.

Version Mehrdimensional Tabellarisch 110x Tabellarisch 1200 Tabellarisch 1400 Tabellarisch 1500
Azure Analysis Services Nicht verfügbar Nicht verfügbar TMSL TMSL TMSL
SQL Server 2019 Analysis Services ASSL ASSL TMSL TMSL TMSL
SQL Server 2017 Analysis Services ASSL ASSL TMSL TMSL Nicht verfügbar
SQL Server 2016 Analysis Services ASSL ASSL TMSL Nicht verfügbar Nicht verfügbar
SQL Server 2014 Analysis Services ASSL ASSL Nicht verfügbar Nicht verfügbar Nicht verfügbar
SQL Server 2012 Analysis Services ASSL ASSL Nicht verfügbar Nicht verfügbar Nicht verfügbar