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.

  1. Localize o comando que você deseja usar: Referência de TMSL – Comandos

  2. Verifique a referência de definição de objeto para objetos usados no comando: Referência de TMSL – Objetos

  3. Escolha um método para executar o script TMSL:

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.

SSAS_TabularMetadata

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