Referencia Tabular Model Scripting Language (TMSL)

Se aplica a: SQL Server 2016 y versiones posteriores Analysis Services Azure Analysis Services Fabric/Power BI Premium

Tabular Model Scripting Language (TMSL) es la sintaxis de definición del modelo de objetos y comandos para los modelos de datos tabulares en el nivel de compatibilidad 1200 o superior. TMSL se comunica con Analysis Services a través del protocolo XMLA, donde el XMLA.Execute método acepta scripts de instrucciones basados en JSON en TMSL, así como los scripts tradicionales basados en XML en Analysis Services Scripting Language (ASSL para XMLA).

Elementos clave de TMSL:

• Metadatos tabulares basados en la semántica del modelo tabular.

  Un modelo tabular se compone de tablas, columnas y relaciones. Las definiciones de objetos equivalentes en TMSL son ahora, no sorprendentemente, tablas, columnas, relaciones, etc. Un nuevo motor de metadatos admite estas definiciones.

• Las definiciones de objeto se estructuran como JSON en lugar de XML.

  Con la excepción de cómo se da formato a la carga (en JSON o XML), TMSL y ASSL son funcionalmente equivalentes en la forma en que proporcionan comandos y metadatos a los métodos XMLA usados para la comunicación del servidor y la transferencia de datos.

Cómo usar TMSL

La manera más fácil de explorar el scripting TMSL es usar los comandos CREATE, ALTER, DELETE o Process en SQL Server Management Studio (SSMS) en un modelo que ya conoce.

1. Busque el comando que desea usar: Referencia de TMSL - Comandos

2. Compruebe la referencia de definición de objeto para los objetos usados en el comando: TmSL Reference - Objects

3. Elija un método para ejecutar el script TMSL:

   • Ventana XMLA en SSMS

   • Invoke-ASCmd Cmdlet de PowerShell

   • Analysis Services Ejecuta la tarea DDL en SSIS.

Esquema de definición de modelo

En la captura de pantalla siguiente se muestra una versión abreviada del esquema, contraída para mostrar los objetos principales.

Lenguajes de scripting en Analysis Services

Analysis Services admite lenguajes de scripting ASSL y TMSL. Solo los modelos tabulares creados en el nivel de compatibilidad 1200 o superior se describen en TMS en formato JSON.

Analysis Services Scripting Language (ASSL para XMLA) fue el primer lenguaje de scripting y sigue siendo el único lenguaje de scripting para modelos multidimensionales y modelos tabulares en niveles de compatibilidad inferiores (1100 o 1103). En ASSL, los modelos tabulares en 110x se describen en términos multidimensionales, como cubo (para un modelo) y grupo de medida (para una tabla).

La tabla siguiente es la matriz del lenguaje de scripting para los modelos de datos de Analysis Services en distintas plataformas o versiones en niveles de compatibilidad específicos.