Objeto Model (TMSL)

Se aplica a: SQL Server 2016 y versiones posteriores analysis Services Azure Analysis Services Fabric/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 cualquier 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 este motivo, se puede encontrar una sintaxis parcial que resalta los elementos principales a continuación, 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 sepa bien. Use la opción Ver código en SQL Server Data Tools para ver su definición. Recuerde instalar un editor JSON para que pueda ver el código. Para obtener un editor JSON en Visual Studio, descargue 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 a la vez. Para cualquier objeto distinto de 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 el nombre, el tipo, la descripción, una colección de propiedades y las 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 el modo DirectQuery, esta propiedad determina qué particiones se usan para ejecutar consultas en el modelo. Los valores válidos incluyen Full y Sample.

culture
Referencia cultural que se va a usar para dar formato.

collation
La secuencia de intercalación.

Tablas
Colección completa de tablas del modelo, incluidas particiones, columnas, medidas, KPI y anotaciones. Consulte Tables (objeto) (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 El 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 se usan para las consultas de paso a través. 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 el lenguaje de scripting de modelos tabulares (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": {  }  
    }