表格式模型指令碼語言 (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 指令碼語言中的傳統 XML 型腳本， (適用于 XMLA 的 ASSL) 。

TMSL 的主要元素：

• 以表格式模型語意為基礎的表格式中繼資料。

  表格式模型是由資料表、資料行和關聯性所組成。 TMSL 中的對等物件定義現在並不令人意外，資料表、資料行、關聯性等等。 新的中繼資料引擎支援這些定義。

• 物件定義會結構化為 JSON，而不是 XML。

  除了 JSON 或 XML) 中的承載格式化方式 (之外，TMSL 和 ASSL 的功能等同于它們如何提供命令和中繼資料給用於伺服器通訊和資料傳輸的 XMLA 方法。

如何使用 TMSL

探索 TMSL 腳本最簡單的方式，是在您已知道的模型上使用SQL Server Management Studio (SSMS) 中的 CREATE、ALTER、DELETE 或 Process 命令。

1. 尋找您想要使用的命令： TMSL 參考 - 命令

2. 檢查命令中使用的物件物件定義參考： TMSL 參考 - 物件

3. 選擇執行 TMSL 腳本的方法：

   • SSMS 中的 XMLA 視窗

   • Invoke-ASCmd PowerShell Cmdlet

   • Analysis Services 在 SSIS 中執行 DDL 工作。

模型定義架構

下列螢幕擷取畫面顯示架構的縮寫版本，已折迭以顯示主要物件。

Analysis Services 中的指令碼語言

Analysis Services 支援 ASSL 和 TMSL 指令碼語言。 只有以 1200 相容性層級或更高層級建立的表格式模型會以 JSON 格式的 TMS 描述。

Analysis Services Scripting Language (ASSL for XMLA) 是第一個指令碼語言，而且仍然是低相容性層級的多維度模型和表格式模型的唯一指令碼語言， (1100 或 1103) 。 在 ASSL 中，以多維度詞彙描述表格式模型，例如模型) 的 Cube (，以及資料表) 的 量值群組 (。

注意

在 [SQL Server Data Tools (SSDT) 中，您可以將舊版表格式模型升級為使用 TMSL，方法是將其CompatibilityLevel切換為 1200 或更高版本。 請記住，升級無法復原。 升級之前，請備份您的模型，以防您稍後需要原始版本。

下表是特定相容性層級上不同平臺/版本之 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