Objeto Model (TMSL)

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

Define un modelo tabular. Hay un modelo por base de datos y solo una base de datos que se puede especificar en un comando determinado. Un objeto Database es el objeto primario.

Las definiciones de modelo son demasiado grandes para reproducir toda la sintaxis en un tema. Por esta razón, a continuación se puede encontrar una sintaxis parcial que resalta las partes principales, con vínculos a objetos secundarios.

Quizás la mejor manera de comprender una definición de modelo es empezar con un modelo tabular que conozca bien. Use la opción Ver código de SQL Server Data Tools para ver su definición. No olvide instalar un editor JSON para que pueda ver el código. Puede obtener un editor JSON en Visual Studio descargando la edición Community u otra edición de Visual Studio.

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 modelo también tienen las siguientes propiedades.

storageLocation
La ubicación en disco donde se va a colocar el modelo.

defaultMode
El método predeterminado para hacer que los datos estén disponibles en la partición.

defaultDataView
Para los modelos en modo DirectQuery, esta propiedad determina qué particiones se usan para ejecutar consultas en el modelo. Los valores válidos son Full y Sample.

culture
Referencia cultural que se usará para el formato.

collation
La secuencia de intercalación.

Tablas
Colección completa de tablas del modelo, incluidas particiones, columnas, medidas, KPI y anotaciones. Consulte El objeto Tables (TMSL) para obtener más información.

relationships
Especifica la relación entre cada par de tablas, incluidas las propiedades que establecen la dirección del filtro y la seguridad. Consulte Objeto Relationships (TMSL) para obtener más información.

Datasources
Una o varias conexiones a bases de datos externas que proporcionan datos al modelo o que se usan para pasar a través de consultas. Consulte El objeto DataSources (TMSL) para obtener más información.

roles
Objetos que asocian un permiso de base de datos, cuentas de miembro y, opcionalmente, filtros de seguridad en DAX para el control de acceso personalizado.

Uso

Los objetos de modelo contienen un modelo completo. Debe especificar un modelo o su objeto database primario en la mayoría de los comandos.

Al crear, reemplazar o modificar un objeto de modelo, 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 muestran las propiedades de primer nivel. Vea Definiciones de objetos en tabular Model Scripting Language (TMSL) para obtener una lista de objetos secundarios.

    "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": {  }  
    }