Объект Model (TMSL)

Применимо к: SQL Server 2016 и более поздних версий Analysis Services Azure Analysis Services Fabric/Power BI Premium

Определяет табличную модель. Существует одна модель на каждую базу данных и только одну базу данных, которую можно указать в любой заданной команде. Объект Database является родительским объектом.

Определения моделей слишком велики для воспроизведения всего синтаксиса в одном разделе. По этой причине ниже можно найти частичный синтаксис, выделяющий main части со ссылками на дочерние объекты.

Возможно, лучший способ понять определение модели — начать с табличной модели, которую вы хорошо знаете. Используйте параметр Просмотреть код в SQL Server Data Tools, чтобы просмотреть его определение. Не забудьте установить редактор JSON, чтобы можно было просмотреть код. Редактор JSON можно получить в Visual Studio , скачав выпуск Community или другой выпуск Visual Studio.

Примечание

В любом скрипте можно ссылаться только на одну базу данных. Для любого объекта, отличного от самой базы данных, свойство Database является необязательным, если указана модель. Существует сопоставление "один к одному" между моделью и базой данных, которое можно использовать для определения имени базы данных, если оно не указано явным образом.
Аналогичным образом можно оставить параметр Модель, задав ее свойства в базе данных.

Определение объекта

Все объекты имеют общий набор свойств, включая имя, тип, описание, коллекцию свойств и заметки. Объекты модели также имеют следующие свойства.

storageLocation
Место на диске, где размещается модель.

defaultMode
Метод по умолчанию для предоставления доступа к данным в секции.

defaultDataView
Для моделей в режиме DirectQuery это свойство определяет, какие секции используются для выполнения запросов к модели. Допустимые значения: Full и Sample.

culture
Язык и региональные параметры, используемые для форматирования.

collation
Последовательность параметров сортировки.

В таблицах
Полная коллекция таблиц в модели, включая секции, столбцы, меры, ключевые показатели эффективности и заметки. Дополнительные сведения см. в разделе Объект Tables (TMSL).

relationships
Указывает связь между каждой парой таблиц, включая свойства, которые задают направление фильтра и безопасность. Дополнительные сведения см. в разделе Объект Связей (TMSL).

dataSources
Одно или несколько подключений к внешним базам данных, предоставляющих данные модели или используемых для передачи запросов. Дополнительные сведения см. в разделе Объект DataSources (TMSL).

Роли
Объекты, которые связывают разрешение базы данных, учетные записи участников и при необходимости фильтры безопасности в DAX для пользовательского управления доступом.

Использование

Объекты модели содержат модель целиком. В большинстве команд необходимо указать один объект Model и (или) ее родительский объект Database.

При создании, замене или изменении объекта модели укажите все свойства определения объекта для чтения и записи. Пропуск свойства чтения и записи считается удалением.

Частичный синтаксис

Так как это определение объекта настолько велико, в списке отображаются только свойства первого уровня. Список дочерних объектов см. в разделе Определения объектов на языке скриптов табличных моделей (TMSL).

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