Objeto Database (TMSL)

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

Define una base de datos tabular en el nivel de compatibilidad 1200 o superior, en función de un modelo del mismo nivel. En este tema se documenta la definición de objeto de una base de datos, lo que proporciona la carga útil para las solicitudes que crean, modifican, eliminan y realizan tareas de administración de bases de datos.

Nota

En cualquier script, solo se puede hacer referencia a una base de datos en ese momento. Para cualquier objeto que no sea la propia base de datos, la propiedad Database es opcional si especifica el modelo. Hay una asignación uno a uno entre un modelo y una base de datos que se puede usar para deducir el nombre de la base de datos si no se proporciona explícitamente.
Del mismo modo, puede dejar fuera Modelo, estableciendo sus propiedades en la base de datos.

Definición del objeto

Todos los objetos tienen un conjunto común de propiedades, como nombre, tipo, descripción, una colección de propiedades y anotaciones. Los objetos de base de datos también tienen las siguientes propiedades.

compatibilitylevel Actualmente, los valores válidos son 1200, 1400. Los niveles de compatibilidad inferiores usan un motor de metadatos diferente.

readwritemode Enumera el modo de la base de datos. Es habitual hacer que una base de datos sea de solo lectura en configuraciones de alta disponibilidad o escalabilidad. Los valores válidos incluyen readWrite,
Readonly
o readOnlyExclusive.

Uso

Los objetos de base de datos se usan en casi todos los comandos. Consulte Commands in Tabular Model Scripting Language (TMSL) para obtener una lista. Un objeto Database es un elemento secundario de un objeto Server.

Al crear, reemplazar o modificar un objeto de base de datos, especifique todas las propiedades de lectura y escritura de la definición de objeto. La omisión de una propiedad de lectura y escritura se considera una eliminación.

Sintaxis parcial

Dado que esta definición de objeto es tan grande, solo se enumeran las propiedades directas. El objeto Model proporciona la mayor parte de la definición de base de datos. Consulte Objeto de modelo (TMSL) para obtener más información sobre cómo se define el objeto.

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