Tabular Model Scripting Language (TMSL) のリファレンス

  • [アーティクル]

適用対象:SQL Server 2016 以降の Analysis Services Azure Analysis Services Fabric/Power BI Premium

表形式モデル スクリプト言語 (TMSL) は、互換性レベル 1200 以上の表形式データ モデルのコマンドおよびオブジェクト モデル定義構文です。 TMSL は XMLA プロトコルを介して Analysis Services と通信します。このメソッドは XMLA.Execute 、TMSL の JSON ベースの ステートメント スクリプトと Analysis Services スクリプト言語 (XMLA 用 ASSL) の従来の XML ベースのスクリプトの両方を受け入れます。

TMSL の主な要素:

  • 表形式モデルのセマンティクスに基づく表形式メタデータ。

    表形式モデルは、テーブル、列、およびリレーションシップで構成されます。 TMSL の同等のオブジェクト定義は、テーブル、列、リレーションシップなど、驚くべきことではありません。 新しいメタデータ エンジンでは、これらの定義がサポートされています。

  • オブジェクト定義は、XML ではなく JSON として構成されます。

    ペイロードの書式設定方法 (JSON または XML) を除き、TMSL と ASSL は、サーバー通信とデータ転送に使用される XMLA メソッドにコマンドとメタデータを提供する方法で機能的に同等です。

TMSL の使用方法

TMSL スクリプトを調べる最も簡単な方法は、既に知っているモデルの SQL Server Management Studio (SSMS) で CREATE、ALTER、DELETE、または Process コマンドを使用することです。

  1. 使用するコマンドを見つけます: TMSL リファレンス - コマンド

  2. コマンドで使用されるオブジェクトのオブジェクト定義参照を確認します。 TMSL 参照 - オブジェクト

  3. TMSL スクリプトを実行する方法を選択します。

モデル定義スキーマ

次のスクリーンショットは、スキーマの省略形バージョンを示しています。折りたたまれていると、主要なオブジェクトが表示されます。

SSAS_TabularMetadata

Analysis Services でのスクリプト言語

Analysis Services では、ASSL および TMSL スクリプト言語がサポートされています。 1200 以上の互換性レベルで作成された表形式モデルのみが、TMS で JSON 形式で記述されます。

Analysis Services Scripting Language (ASSL for XMLA) は最初のスクリプト言語であり、下位互換性レベル (1100 または 1103) の多次元モデルと表形式モデルの唯一のスクリプト言語です。 ASSL では、110x の表形式モデルは、 キューブ (モデルの場合) や メジャー グループ (テーブルの場合) など、多次元用語で説明されています。

注意

[SQL Server Data Tools (SSDT) では、CompatibilityLevel を 1200 以上に切り替えることで、TMSL を使用するように以前のバージョンの表形式モデルをアップグレードできます。 アップグレードは元に戻すことができないことに注意してください。 アップグレードする前に、後で元のバージョンが必要な場合に備えてモデルをバックアップします。

次の表は、特定の互換性レベルのさまざまなプラットフォーム/バージョンにわたる Analysis Services データ モデルのスクリプト言語マトリックスです。

バージョン 多次元 表形式 110x 表形式 1200 表形式 1400 表形式 1500 表形式 1600
Power BI Premium NA NA NA NA TMSL TMSL
Azure Analysis Services NA NA 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 NA
SQL Server 2017 Analysis Services ASSL ASSL TMSL TMSL NA NA
SQL Server 2016 Analysis Services ASSL ASSL TMSL NA NA NA
SQL Server 2014 Analysis Services ASSL ASSL NA NA NA NA
SQL Server 2012 Analysis Services ASSL ASSL NA NA NA NA