TMSL-Referenz (Tabular Model Scripting Language)

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

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

Wichtige Elemente von TMSL:

  • Tabellarische Metadaten basierend auf tabellarischer Modellsemantik.

    Ein tabellarisches Modell besteht aus Tabellen, Spalten und Beziehungen. Entsprechende Objektdefinitionen in TMSL sind jetzt, nicht überraschend, Tabellen, Spalten, Beziehungen und so weiter. Ein neues Metadatenmodul unterstützt diese Definitionen.

  • Objektdefinitionen werden anstelle von XML als JSON strukturiert.

    Abgesehen davon, wie die Nutzlast formatiert ist (in JSON oder XML), sind TMSL und ASSL funktionell gleichwertig, um Befehle und Metadaten für XMLA-Methoden bereitzustellen, die für die Serverkommunikation und Die Datenübertragung verwendet werden.

Verwenden von TMSL

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

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

  2. Überprüfen Sie den Objektdefinitionsverweis auf 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 gekürzte Version des Schemas, die reduziert wird, um die hauptobjekte anzuzeigen.

SSAS_TabularMetadata

Skriptsprachen in Analysis Services

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

Analysis Services Scripting Language (ASSL for XMLA) war die erste Skriptsprache und ist weiterhin die einzige Skriptsprache für mehrdimensionale Modelle und Tabularmodelle auf niedrigeren Kompatibilitätsebenen (1100 oder 1103). In ASSL werden tabellarische Modelle mit 110x in mehrdimensionalen Ausdrücken beschrieben , z. B. Cube (für ein Modell) und Maßgruppe (für eine Tabelle).

Hinweis

In [SQL Server Data Tools (SSDT) können Sie ein früheres tabellarisches Modell aktualisieren, um TMSL zu verwenden, indem Sie den Kompatibilitätslevel auf 1200 oder höher umstellen. Denken Sie daran, dass das Upgrade unumwendbar ist. Vor dem Upgrade sichern Sie Ihr Modell, wenn Sie die ursprüngliche Version später benötigen.

Die folgende Tabelle ist die Skriptsprachematrix für Analysis Services-Datenmodelle auf verschiedenen Plattformen/Versionen auf bestimmten Kompatibilitätsebenen.

Version Mehrdimensional Tabellarische 110x Tabellarische 1200 Tabellarische 1400 Tabellarische 1500 Tabellarische 1600
Power BI Premium Nicht verfügbar Nicht verfügbar Nicht verfügbar Nicht verfügbar TMSL TMSL
Azure Analysis Services Nicht verfügbar Nicht verfügbar TMSL TMSL TMSL TMSL
SQL Server 2022 Analysis Services ASSL ASSL TMSL TMSL TMSL TMSL
SQL Server 2019 Analysis Services ASSL ASSL TMSL TMSL TMSL Nicht verfügbar
SQL Server 2017 Analysis Services ASSL ASSL TMSL TMSL Nicht verfügbar Nicht verfügbar
SQL Server 2016 Analysis Services ASSL ASSL TMSL Nicht verfügbar Nicht verfügbar Nicht verfügbar
SQL Server 2014 Analysis Services ASSL ASSL Nicht verfügbar 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 Nicht verfügbar