Referência de TMSL (Linguagem de Scripts do Modelo Tabular)
Aplica-se a:
SQL Server 2016 e posteriores do Analysis Services Azure Analysis Services Fabric/Power BI Premium
TMSL (Linguagem de Script de Modelo tabular) é a sintaxe de definição de modelo de objeto e comando para modelos de dados tabulares no nível de compatibilidade 1200 ou superior. O TMSL se comunica com o Analysis Services por meio do protocolo XMLA, em que o XMLA.Execute método aceita scripts de instrução baseados em JSON no TMSL, bem como os scripts tradicionais baseados em XML na LINGUAGEM de Script do Analysis Services (ASSL para XMLA).
Principais elementos do TMSL:
Metadados tabulares com base na semântica de modelo tabular.
Um modelo tabular é composto por tabelas, colunas e relações. As definições de objeto equivalentes no TMSL são agora, não surpreendentemente, tabelas, colunas, relações e assim por diante. Um novo mecanismo de metadados dá suporte a essas definições.
As definições de objeto são estruturadas como JSON em vez de XML.
Com exceção de como o conteúdo é formatado (em JSON ou XML), tanto TMSL quanto ASSL são funcionalmente equivalentes em como fornecem comandos e metadados para métodos XMLA usados para comunicação do servidor e transferência de dados.
Como usar o TMSL
A maneira mais fácil de explorar o script TMSL é usando os comandos CREATE, ALTER, DELETE ou Process no SSMS (SQL Server Management Studio) em um modelo que você já conhece.
Localize o comando que você deseja usar: Referência de TMSL – Comandos
Verifique a referência de definição de objeto para objetos usados no comando: Referência de TMSL – Objetos
Escolha um método para executar o script TMSL:
Janela XMLA no SSMS
Invoke-ASCmd Cmdlet do PowerShell
Esquema de definição de modelo
A captura de tela a seguir mostra uma versão abreviada do esquema, recolhida para mostrar os objetos principais.
Linguagens de script no Analysis Services
O Analysis Services dá suporte a linguagens de script ASSL e TMSL. Somente modelos tabulares criados no nível de compatibilidade 1200 ou superior são descritos em TMS no formato JSON.
A ASSL (Linguagem de Script do Analysis Services para XMLA) foi a primeira linguagem de script e ainda é a única linguagem de script para modelos multidimensionais e modelos tabulares em níveis de compatibilidade inferiores (1100 ou 1103). No ASSL, modelos tabulares a 110x são descritos em termos multidimensionais, como cubo (para um modelo) e grupo de medidas (para uma tabela).
Observação
No [SQL Server Data Tools (SSDT), você pode atualizar um modelo de tabela de versão anterior para usar o TMSL alternando seu CompatibilityLevel para 1200 ou superior. Lembre-se de que a atualização é irreversível. Antes de atualizar, faça backup do modelo caso precise da versão original mais tarde.
A tabela a seguir é a matriz de linguagem de script para modelos de dados do Analysis Services em diferentes plataformas/versões em níveis de compatibilidade específicos.
| Versão | Multidimensional | Tabular 110x | Tabular 1200 | Tabular 1400 | Tabular 1500 | Tabular 1600 |
|---|---|---|---|---|---|---|
| Power BI Premium | NA | NA | NA | NA | TMSL | TMSL |
| Azure Analysis Services | NA | NA | TMSL | TMSL | TMSL | TMSL |
| SQL Server Analysis Services 2022 | ASSL | ASSL | TMSL | TMSL | TMSL | TMSL |
| SQL Server Analysis Services 2019 | ASSL | ASSL | TMSL | TMSL | TMSL | NA |
| SQL Server Analysis Services 2017 | 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 Serviços de análise | ASSL | ASSL | NA | NA | NA | NA |