Model, objet (TMSL)

  • Article

S’applique à : SQL Server 2016 et versions ultérieures Analysis Services Azure Analysis Services Fabric/Power BI Premium

Définit un modèle tabulaire. Il existe un modèle par base de données et une seule base de données qui peut être spécifiée dans une commande donnée. Un objet Database est l’objet parent.

Les définitions de modèle sont trop volumineuses pour reproduire la syntaxe entière dans une seule rubrique. Pour cette raison, vous trouverez ci-dessous une syntaxe partielle mettant en évidence les parties main, avec des liens vers des objets enfants.

La meilleure façon de comprendre une définition de modèle consiste peut-être à commencer par un modèle tabulaire que vous connaissez bien. Utilisez l’option Afficher le code dans SQL Server Data Tools pour afficher sa définition. N’oubliez pas d’installer un éditeur JSON afin de pouvoir afficher le code. Vous pouvez obtenir un éditeur JSON dans Visual Studio en téléchargeant l’édition Community ou une autre édition de Visual Studio.

Notes

Dans n’importe quel script, une seule base de données à la fois peut être référencée. Pour tout objet autre que la base de données proprement dite, la propriété Database est facultative si vous spécifiez le modèle. Il existe un mappage un-à-un entre un modèle et une base de données qui peut être utilisé pour déduire le nom de la base de données s’il n’est pas fourni explicitement.
De même, vous pouvez ignorer Model, en définissant ses propriétés sur la base de données.

Définition de l'objet

Tous les objets ont un ensemble commun de propriétés, notamment le nom, le type, la description, une collection de propriétés et des annotations. Les objets de modèle ont également les propriétés suivantes.

storageLocation
Emplacement sur le disque où placer le modèle.

defaultMode
Méthode par défaut pour rendre les données disponibles dans la partition.

defaultDataView
Pour les modèles en mode DirectQuery, cette propriété détermine les partitions utilisées pour exécuter des requêtes sur le modèle. Les valeurs valides sont Full et Sample.

culture
Culture à utiliser pour la mise en forme.

collation
Séquence de classement.

dans des tables
Collection complète de tables dans le modèle, y compris les partitions, les colonnes, les mesures, les indicateurs de performance clés et les annotations. Pour plus d’informations, consultez Objet Tables (TMSL).

relationships
Spécifie la relation entre chaque paire de tables, y compris les propriétés qui définissent la direction et la sécurité du filtre. Pour plus d’informations, consultez Objet Relations (TMSL).

dataSources
Une ou plusieurs connexions à des bases de données externes fournissant des données au modèle ou utilisées pour les requêtes de passage. Pour plus d’informations, consultez Objet DataSources (TMSL).

roles
Objets qui associent une autorisation de base de données, des comptes membres et éventuellement des filtres de sécurité dans DAX pour le contrôle d’accès personnalisé.

Utilisation

Les objets de modèle contiennent un modèle entier. Vous devez spécifier un modèle et/ou son objet Database parent dans la plupart des commandes.

Lors de la création, du remplacement ou de la modification d’un objet de modèle, spécifiez toutes les propriétés en lecture-écriture de la définition de l’objet. L’omission d’une propriété en lecture-écriture est considérée comme une suppression.

Syntaxe partielle

Étant donné que cette définition d’objet est si volumineuse, seules les propriétés de premier niveau sont répertoriées. Pour obtenir la liste des objets enfants, consultez Définitions d’objets dans le langage TMSL (Tabular Model Scripting Language).

    "model": {  
      "description": "Model object of a tabular database",  
      "type": "object",  
      "properties": {  
          "name": {  },  
          "description": {  },  
         "storageLocation": {  },  
         "defaultMode":  {  },  
         "defaultDataView": {  },  
         "culture": {  },  
         "collation": {  },  
         "annotations": {  },  
         "tables": {  },  
         "relationships": {  },  
         "dataSources": {  },  
         "perspectives": {  },  
            "cultures": {  },  
         "roles": {  }  
    }