Справочник по языку TMSL

  • Статья

Применимо к: SQL Server 2016 и более поздних версий Analysis Services Azure Analysis Services Fabric/Power BI Premium

Язык скриптов табличных моделей (TMSL) — это синтаксис определения команд и объектной модели для табличных моделей данных на уровне совместимости 1200 или выше. TMSL взаимодействует со службами Analysis Services по протоколу XMLA, где XMLA.Execute метод принимает как скрипты инструкций на основе JSON в TMSL, так и традиционные скрипты на основе XML на языке сценариев служб Analysis Services (ASSL для XMLA).

Ключевые элементы TMSL:

  • Табличные метаданные на основе семантики табличной модели.

    Табличная модель состоит из таблиц, столбцов и связей. Эквивалентные определения объектов в TMSL теперь являются таблицами, столбцами, связями и т. д. Новый механизм метаданных поддерживает эти определения.

  • Определения объектов структурированы как JSON, а не XML.

    За исключением форматирования полезных данных (в JSON или XML), TMSL и ASSL функционально эквивалентны в том, как они предоставляют команды и метаданные методам XMLA, используемым для обмена данными с сервером и передачи данных.

Использование TMSL

Самый простой способ изучить скрипты TMSL — использовать команды CREATE, ALTER, DELETE или Process в SQL Server Management Studio (SSMS) в уже известной модели.

  1. Найдите нужную команду: Справочник по TMSL — команды

  2. Проверьте ссылку на определение объектов, используемых в команде TMSL Reference — Objects

  3. Выберите метод для выполнения скрипта TMSL:

Схема определения модели

На следующем снимку экрана показана сокращенная версия схемы, свернутая для отображения основных объектов.

SSAS_TabularMetadata

Языки сценариев в службах Analysis Services

Службы Analysis Services поддерживают языки сценариев ASSL и TMSL. В TMS в формате JSON описаны только табличные модели, созданные на уровне совместимости 1200 или выше.

Язык сценариев служб Analysis Services (ASSL для XMLA) был первым языком сценариев и по-прежнему является единственным языком сценариев для многомерных моделей и табличных моделей с более низким уровнем совместимости (1100 или 1103). В ASSL табличные модели в 110x описываются в многомерных терминах, таких как куб (для модели) и measuregroup (для таблицы).

Примечание

В [SQL Server Data Tools (SSDT) вы можете обновить табличную модель более ранней версии для использования TMSL, переключив ее CompatibilityLevel на 1200 или выше. Помните, что обновление является необратимым. Перед обновлением создайте резервную копию модели на случай, если вам понадобится исходная версия позже.

В следующей таблице приведена матрица языка сценариев для моделей данных служб Analysis Services на разных платформах и версиях на определенных уровнях совместимости.

Версия Многомерная Табличное значение 110x Табличный 1200 Табличный 1400 Табличный 1500 Табличный 1600
Power BI Premium Н/Д Н/Д Н/Д Н/Д TMSL TMSL
Azure Analysis Services Н/Д Н/Д TMSL TMSL TMSL TMSL
SQL Server 2022 Analysis Services ASSL ASSL TMSL TMSL TMSL TMSL
службы Analysis Services SQL Server 2019 ASSL ASSL TMSL TMSL TMSL Н/Д
SQL Server 2017 Analysis Services ASSL ASSL TMSL TMSL Н/Д Н/Д
Службы SQL Server 2016 Analysis Services ASSL ASSL TMSL Н/Д Н/Д Н/Д
SQL Server 2014 Analysis Services ASSL ASSL Н/Д Н/Д Н/Д Н/Д
SQL Server 2012 Службы Analysis Services ASSL ASSL Н/Д Н/Д Н/Д Н/Д