Riferimento al Tabular Model Scripting Language (TMSL)

Si applica a: SQL Server 2016 e versioni successive di Analysis Services Azure Analysis Services Fabric/Power BI Premium

Il linguaggio TMSL (Tabular Model Scripting Language) è la sintassi di definizione del modello a oggetti e dei comandi per i modelli di dati tabulari al livello di compatibilità 1200 o superiore. TMSL comunica con Analysis Services tramite il protocollo XMLA, in cui il XMLA.Execute metodo accetta sia script di istruzione basati su JSON in TMSL che gli script tradizionali basati su XML in Analysis Services Scripting Language (ASSL per XMLA).

Elementi chiave di TMSL:

• Metadati tabulari basati sulla semantica del modello tabulare.

  Un modello tabulare è costituito da tabelle, colonne e relazioni. Le definizioni di oggetti equivalenti in TMSL sono ora, non sorprendentemente tabelle, colonne, relazioni e così via. Un nuovo motore di metadati supporta queste definizioni.

• Le definizioni degli oggetti sono strutturate come JSON anziché XML.

  Ad eccezione del modo in cui il payload viene formattato (in JSON o XML), TMSL e ASSL sono funzionalmente equivalenti nel modo in cui forniscono comandi e metadati ai metodi XMLA usati per la comunicazione del server e il trasferimento dei dati.

Come usare TMSL

Il modo più semplice per esplorare gli script TMSL consiste nell'usare i comandi CREATE, ALTER, DELETE o Process in SQL Server Management Studio (SSMS) in un modello già noto.

1. Trovare il comando che si vuole usare: Riferimento TMSL - Comandi

2. Controllare il riferimento alla definizione dell'oggetto per gli oggetti usati nel comando: Riferimento TMSL - Oggetti

3. Scegliere un metodo per l'esecuzione dello script TMSL:

   • Finestra XMLA in SSMS

   • Invoke-ASCmd Cmdlet di PowerShell

   • Attività Esegui DDL di Analysis Services in SSIS.

Schema di definizione del modello

Lo screenshot seguente mostra una versione abbreviata dello schema, compressa per mostrare gli oggetti principali.

Linguaggi di scripting in Analysis Services

Analysis Services supporta i linguaggi di scripting ASSL e TMSL. Solo i modelli tabulari creati al livello di compatibilità 1200 o superiore sono descritti in TMS in formato JSON.

Analysis Services Scripting Language (ASSL per XMLA) è stato il primo linguaggio di scripting ed è ancora l'unico linguaggio di scripting per i modelli multidimensionali e i modelli tabulari a livelli di compatibilità inferiori (1100 o 1103). In ASSL i modelli tabulari a 110x sono descritti in termini multidimensionali, ad esempio cubo (per un modello) e measuregroup (per una tabella).

La tabella seguente è la matrice del linguaggio di scripting per i modelli di dati di Analysis Services in piattaforme/versioni diverse a livelli di compatibilità specifici.