Database, objet (TMSL)

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

Définit une base de données tabulaire au niveau de compatibilité 1200 ou supérieur, en fonction d’un modèle du même niveau. Cette rubrique documente la définition d’objet d’une base de données, en fournissant la charge utile pour les demandes qui créent, modifient, suppriment et effectuent des tâches de gestion de base de données.

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 elle-même, 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 laisser de côté 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 les annotations. Les objets de base de données ont également les propriétés suivantes.

niveau de compatibilité Actuellement, les valeurs valides sont 1200, 1400. Les niveaux de compatibilité inférieurs utilisent un moteur de métadonnées différent.

readwritemode Énumère le mode de la base de données. Il est courant de rendre une base de données en lecture seule dans les configurations de haute disponibilité ou de scalabilité. Les valeurs valides incluent readWrite,
Readonly
ou readOnlyExclusive.

Utilisation

Les objets de base de données sont utilisés dans presque toutes les commandes. Pour obtenir une liste, consultez Commandes in Tabular Model Scripting Language (TMSL). Un objet Database est un enfant d’un objet Server.

Lors de la création, du remplacement ou de la modification d’un objet de base de données, 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 directes sont répertoriées. L’objet Model fournit l’essentiel de la définition de base de données. Consultez Objet de modèle (TMSL) pour en savoir plus sur la façon dont l’objet est défini.

    "database": {  
      "type": "object",  
      "properties": {  
        "name": {  
          "type": "string"  
        },  
        "id": {  
          "type": "string"  
        },  
        "description": {  
          "type": "string"  
        },  
        "compatibilityLevel": {  
          "type": "integer"  
        },  
        "readWriteMode": {  
          "enum": [  
            "readWrite",  
            "readOnly",  
            "readOnlyExclusive"  
          ]  
        },  
        "model": {  
          "type": "object",  
          ...  
        }  
    }