Справочник по языку 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) в уже известной модели.
Найдите нужную команду: Справочник по TMSL — команды
Проверьте ссылку на определение объектов, используемых в команде TMSL Reference — Objects
Выберите метод для выполнения скрипта TMSL:
Окно XMLA в SSMS
Invoke-ASCmd Командлет PowerShell
Службы Analysis Services выполняют задачу DDL в службах SSIS.
Схема определения модели
На следующем снимку экрана показана сокращенная версия схемы, свернутая для отображения основных объектов.
Языки сценариев в службах 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 | Н/Д | Н/Д | Н/Д | Н/Д |