Compartilhar via

Referência de TMSL (linguagem de script de modelo de tabela)

Aplica-se a: Analysis Services do SQL Server 2016 e posteriores Azure Analysis Services Fabric/Power BI Premium

A TMSL (Tabular Model Scripting Language) é a sintaxe de definição de modelo de comando e objeto 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 de tabela é composto por tabelas, colunas e relações. As definições de objeto equivalentes no TMSL agora são, 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 a carga é formatada (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 de 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 TMSL – Objetos

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

Esquema de definição de modelo

O trecho a seguir mostra uma versão abreviada do esquema para o nível de compatibilidade do banco de dados 1200 e superior, reduzido para mostrar os objetos principais.

"database": {
  "description": "Database object of Tabular Object Model (TOM)",
  "type": "object",
  "properties": {
    "name": {...},
    "id": {...},
    "description": {...},
    "compatibilityLevel": {...},
    "readWriteMode": {...},
    "model": {
      "description": "Model object of Tabular Object Model (TOM)",
      "type": "object",
      "properties": {
        "name": {...},
        "description": {...},
        "storageLocation": {...},
        "defaultMode": {...},
        "defaultDataView": {...},
        "culture": {...},
        "collation": {...},
        "annotations": {...},
        "tables": {...},
        "relationships": {...},
        "dataSources": {...},
        "perspectives": {...},
        "cultures": {...},
        "roles": {...},
        // "functions": {...}, // For database compatibility level 1702 and above
      },
      "additionalProperties": false
    }
  },
  "additionalProperties": false
}

Linguagens de script no Analysis Services

O Analysis Services dá suporte a linguagens de script ASSL e TMSL. Somente os modelos tabulares criados no nível de compatibilidade 1200 ou superior são descritos no 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, os modelos tabulares em 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 tabular de uma versão anterior para usar o TMSL ao alterar o 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 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 Serviços de análise ASSL ASSL NA NA NA NA
  • Last updated on