Langage TMSL (Tabular Model Scripting Language)

S’applique à : SQL Server 2016 et ultérieur Analysis Services Azure Analysis Services Power BI Premium

Le langage TMSL (Tabular Model Scripting Language) est la syntaxe de définition de la commande et du modèle objet pour les modèles de données tabulaires au niveau de compatibilité 1200 ou supérieur. TMSL communique avec Analysis Services par le biais du protocole XMLA, où la XMLA.Execute méthode accepte les deux scripts d' instruction JSON dans TMSL, ainsi que les scripts XML traditionnels dans Analysis Services langage de script (ASSL pour XMLA).

Éléments clés de TMSL :

  • Métadonnées tabulaires basées sur la sémantique de modèle tabulaire.

    Un modèle tabulaire est composé de tables, de colonnes et de relations. Les définitions d’objets équivalents dans TMSL sont désormais, pas étonnantes, les tables, les colonnes, les relations, etc. Un nouveau moteur de métadonnées prend en charge ces définitions.

  • Les définitions d’objets sont structurées au format JSON au lieu de XML.

    À l’exception de la mise en forme de la charge utile (au format JSON ou XML), TMSL et ASSL sont fonctionnellement équivalents dans la manière dont ils fournissent des commandes et des métadonnées aux méthodes XMLA utilisées pour la communication et le transfert de données sur le serveur.

Utilisation de TMSL

le moyen le plus simple d’explorer les scripts TMSL consiste à utiliser les commandes create, ALTER, DELETE ou Process dans SQL Server Management Studio (SSMS) sur un modèle que vous connaissez déjà.

  1. Recherchez la commande que vous souhaitez utiliser : TMSL Reference-Commands

  2. Vérifiez la référence de définition d’objet pour les objets utilisés dans la commande : TMSL Reference-Objects

  3. Choisissez une méthode pour exécuter le script TMSL :

Schéma de définition de modèle

La capture d’écran suivante montre une version abrégée du schéma, réduite pour afficher les objets principaux.

SSAS_TabularMetadata

Langages de script dans Analysis Services

Analysis Services prend en charge les langages de script ASSL et TMSL. Seuls les modèles tabulaires créés au niveau de compatibilité 1200 ou une version ultérieure sont décrits dans TMS au format JSON.

Analysis Services Scripting Language (ASSL pour XMLA) était le premier langage de script, et est toujours le seul langage de script pour les modèles multidimensionnels et les modèles tabulaires aux niveaux de compatibilité inférieurs (1100 ou 1103). Dans ASSL, les modèles tabulaires de 110x sont décrits en termes multidimensionnels, tels que cube (pour un modèle) et MeasureGroup (pour une table).

Notes

dans [SQL Server Data Tools (SSDT), vous pouvez mettre à niveau un modèle tabulaire de version antérieure pour utiliser TMSL en basculant son CompatibilityLevel sur 1200 ou une version ultérieure. N’oubliez pas que la mise à niveau est irréversible. Avant la mise à niveau, sauvegardez votre modèle si vous avez besoin de la version d’origine ultérieurement.

Le tableau suivant est la matrice du langage de script pour Analysis Services des modèles de données entre différentes versions, à des niveaux de compatibilité spécifiques.

Version Multidimensionnel 110x tabulaire Tableau 1200 Tableau 1400 Tableau 1500
Azure Analysis Services N/D N/D TMSL TMSL TMSL
SQL Server 2019 Analysis Services ASSL ASSL TMSL TMSL TMSL
SQL Server 2017 Analysis Services ASSL ASSL TMSL TMSL N/D
SQL Server 2016 Analysis Services ASSL ASSL TMSL N/D N/D
SQL Server 2014 Analysis Services ASSL ASSL N/D N/D N/D
SQL Server 2012 Analysis Services ASSL ASSL N/D N/D NA