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.
Busque el comando que desea usar: Referencia de TMSL - Comandos
Compruebe la referencia de definición de objeto para los objetos usados en el comando: TmSL Reference - Objects
Elija un método para ejecutar el script TMSL:
Ventana XMLA en SSMS
Invoke-ASCmd Cmdlet de PowerShell
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).
Nota:
En [SQL Server Data Tools (SSDT), puede actualizar un modelo tabular de versión anterior para usar TMSL cambiando su CompatibilityLevel a 1200 o superior. Recuerde que la actualización es irreversible. Antes de actualizar, realice una copia de seguridad del modelo en caso de que necesite la versión original más adelante.
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.
| Versión | Multidimensional | Tabular 110x | Tabular 1200 | Tabular 1400 | Tabular 1500 | Tabular 1600 |
|---|---|---|---|---|---|---|
| Power BI Premium | N/D | N/D | N/D | N/D | TMSL | TMSL |
| Azure Analysis Services | N/D | N/D | 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 | N/D |
| SQL Server 2017 Analysis Services | ASSL | ASSL | TMSL | TMSL | N/D | N/D |
| SQL Server 2016 Analysis Services | ASSL | ASSL | TMSL | N/D | N/D | N/D |
| SQL Server 2014 Analysis Services | ASSL | ASSL | N/D | N/D | N/D | N/D |
| SQL Server 2012 Analysis Services | ASSL | ASSL | N/D | N/D | N/D | N/D |