# IncludeModel

Инструкция IncludeModel загружает продукт данных и его семантическую модель, включая таблицы, связи, меры и измерения. Меры и измерения из семантической модели автоматически появляются в качестве основных элементов в приложении.

IncludeModel data\_product\_name [InEnvironment environment\_name] [FromSpace data\_product\_space | FromCurrentSpace | FromPersonalSpace] [WithTables Table table\_name1 Fields fieldlist Connection dataset\_connection {, Table table\_nameN Fields fieldlist Connection dataset\_connection,... }] [WithMeasures measurelist] [WithDimensions dimensionlist]

Аргументы и ключевые слова

| Аргумент или ключевое слово | Описание |
| --- | --- |
| data\_product\_name | Название продукта данных для загрузки. |
| [FromSpace](https://help.qlik.com/ru-RU/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/ScriptRegularStatements/FromSpace.htm), [FromCurrentSpace](https://help.qlik.com/ru-RU/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/ScriptRegularStatements/FromCurrentSpace.htm), or [FromPersonalSpace](https://help.qlik.com/ru-RU/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/ScriptRegularStatements/FromPersonalSpace.htm) | Ключевые слова, определяющие пространство, из которого загружается продукт данных.<br><br>При необходимости используйте один из следующих вариантов. Если все эти параметры ключевых слов опущены, оператор IncludeModel выполняет поиск продукта данных в вашем личном пространстве.<br><br><ul> <li> <p><span>FromSpace</span>: Загрузить продукт данных, расположенный в пространстве, указанном с помощью <code>data_product_space</code>.</p> </li> <li> <p><span>FromCurrentSpace</span>: Загрузить продукт данных, расположенный в текущем пространстве.</p> </li> <li> <p><span>FromPersonalSpace</span>: Загрузите продукт данных, расположенный в вашем личном пространстве.</p> </li> </ul> |
| data\_product\_space | Указывает пространство продукта данных, который вы хотите загрузить, если вы используете FromSpace для явного указания конкретного пространства, из которого требуется выполнить загрузку. Это неприменимо, если вы используете FromPersonalSpace или FromCurrentSpace.<br><br>Соблюдайте правила использования кавычек, описанные в [Использование кавычек в скрипте](https://help.qlik.com/ru-RU/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/use-quotes-in-script.htm). Примеры:<br><br>`MyAnalyticsSpace`<br>`"My Analytics Space"`<br>`[My Analytics Space]` |
| [InEnvironment](https://help.qlik.com/ru-RU/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/ScriptRegularStatements/InEnvironment.htm) | Ключевое слово, указывающее на использование продукта данных в среде, указанной с помощью `environment_name`.<br><br>Не требуется, если продукт данных не находится в среде. |
| environment\_name | Название среды, если применимо, содержащей продукт данных, который вы хотите загрузить.<br><br>Соблюдайте правила использования кавычек, описанные в [Использование кавычек в скрипте](https://help.qlik.com/ru-RU/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/use-quotes-in-script.htm). Примеры:<br><br>`Production`<br>`[Production Environment]`<br>`"Production Environment"` |
| [WithTables](https://help.qlik.com/ru-RU/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/ScriptRegularStatements/WithTables.htm) | Ключевое слово, указывающее на использование таблиц, определенных в последующих операторах `Table`. |
| [Table](https://help.qlik.com/ru-RU/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/ScriptRegularStatements/Table.htm) | Ключевое слово, указывающее на использование таблицы. Загружает по одной таблице на каждый оператор `Table`. |
| table\_name | Указывает имя таблицы, используемой в модели данных.<br><br>Соблюдайте правила использования кавычек, описанные в [Использование кавычек в скрипте](https://help.qlik.com/ru-RU/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/use-quotes-in-script.htm). Примеры:<br><br>`MyDataTable`<br>`[My Data Table]`<br>`"My Data Table"` |
| [Fields](https://help.qlik.com/ru-RU/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/ScriptRegularStatements/Field.htm) | Ключевое слово, предписывающее использовать указанные поля (fieldlist) из таблицы для интеграции в модель данных. |
| fieldlist | Список полей таблицы, на которую ссылается предшествующий оператор `Table`.<br><br>Вы можете использовать `*`, чтобы использовать все поля таблицы, или указать список конкретных полей через запятую.<br><br>Примеры:<br><br>`Amount, Quantity, Region`<br>`[Amount], [Quantity], [Region]` |
| [Connection](https://help.qlik.com/ru-RU/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/ScriptRegularStatements/Connection.htm) | Ключевое слово, определяющее использование набора данных, указанного в `dataset_connection`. |
| dataset\_connection | Подключение, которое может загрузить набор данных, содержащий таблицу, на которую указывает ссылка.<br><br>В зависимости от местоположения подключения используйте один из следующих форматов:<br><br><ul> <li> <p><span>environment:space:connection</span> — используется для файлов, расположенных внутри сред (контейнеров для данных, синхронизируемых между <span>Qlik Cloud</span> и <span>Qlik Talend Cloud</span>). Окружения связаны с пространствами (в частности, с <span>пространствами данных</span>).</p> <p>Для получения дополнительной информации о средах, см. <a href="https://help.qlik.com/ru-RU/cloud-services/Subsystems/Hub/Content/Sense_Hub/Admin/mc-administer-environments.htm">Синхронизация и управление средами</a>.</p> </li> <li> <p><span>space:connection</span> — Используется для подключений с пространством в качестве контейнера хранилища верхнего уровня или в той же среде, что и загружающее приложение. Это могут быть подключения, расположенные в <span>общих</span>, <span>управляемых</span> пространствах или пространствах данных.</p> <p>Например, для набора данных, хранящегося локально в <span>Qlik Cloud</span> (подключение <span>DataFiles</span>) и расположенного в пространстве с именем <span>Sales Analysis</span>, следует использовать следующее: <span>Sales Analysis:DataFiles</span></p> </li> <li> <p><span>connection</span> — Только имя подключения. Это относится к подключениям, расположенным в вашем <span>личном пространстве</span>. В этом случае подключение будет просто: <span>DataFiles</span></p> </li> </ul><br><br>Примеры:<br><br>`[CustomerOrders:DataFiles]`<br>`[SalesData2026:SnowflakeSales]` |
| [WithMeasures](https://help.qlik.com/ru-RU/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/ScriptRegularStatements/WithMeasures.htm) | Ключевое слово, предписывающее преобразовать указанные меры из продукта данных (measurelist) в основные меры. |
| measurelist | Список мер из семантической модели продукта данных для преобразования в мастер-меры.<br><br>Вы можете использовать `*`, чтобы преобразовать все показатели, или указать список конкретных показателей через запятую.<br><br>Пример:<br><br>`[Sales], [Total Quantity], [Cost]` |
| [WithDimensions](https://help.qlik.com/ru-RU/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/ScriptRegularStatements/WithDimensions.htm) | Ключевое слово, предписывающее преобразовать указанные измерения из продукта данных (dimensionlist) в мастер-измерения. |
| dimensionlist | Список измерений из семантической модели продукта данных для преобразования в мастер-измерения.<br><br>Вы можете использовать `*`, чтобы преобразовать все измерения, или указать список конкретных измерений через запятую.<br><br>Пример:<br><br>`[Product Name], [Region], [Customer]` |

## замечания

Инструкция IncludeModel обычно создается автоматически каталогом данных, когда вы выбираете загрузку продукта данных с его семантической моделью. Вы также можете написать инструкцию вручную или отредактировать сгенерированную инструкцию, чтобы настроить, какие поля, меры и измерения будут включены.

Связи, определенные в семантической модели, автоматически применяются к загруженным таблицам, создавая ассоциации в вашей модели данных.

Операции для мер и измерений применяются в конце загрузки данных после загрузки таблиц и полей. Если загрузка завершается сбоем до этой фазы, никакие операции с мерами или измерениями не применяются.

Примечание к информацииЧтобы использовать оператор IncludeModel, у вас должно быть разрешение Может потреблять данные или Может просматривать в пространстве, содержащем продукт данных.

### Свойства основных элементов

Большинство атрибутов основных элементов, унаследованных из семантических моделей, доступны только для чтения в приложении-потребителе. Некоторые другие атрибуты Основного элемента, например относящиеся к визуализациям, по-прежнему можно редактировать в приложении.

Режим «только для чтения» применяется только к пользовательскому интерфейсу — с помощью API можно задать ряд свойств Основного элемента:

* Свойства, настраиваемые в семантической модели, но доступные только для чтения в пользовательском интерфейсе приложения-потребителя. Сюда входят заголовок, описание и теги.

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

Изменения свойств, определенных семантической моделью, будут перезаписаны при перезагрузке приложения.

### Удаление основного элемента

В неопубликованном приложении можно удалить унаследованный Основной элемент, но он снова появится при следующей перезагрузке, если на него все еще есть ссылка в скрипте IncludeModel. Чтобы окончательно удалить его, сначала удалите его из скрипта. Вы также можете создать дубликат унаследованного Основного элемента. Дубликат представляет собой обычный Основной элемент приложения и полностью доступен для редактирования.

## Пример 1 – Загрузка определенных таблиц вместе со всеми мерами и измерениями

[](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/ScriptRegularStatements/IncludeModel.htm)

#### Загрузить скрипт

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

```
IncludeModel [Sales Performance Data] FromSpace [Sales Analysis Space]
WithTables
    Table [Transactions] Fields * Connection [Sales Analysis Space:DataFiles],
    Table [Products] Fields * Connection [Sales Analysis Space:DataFiles]
WithMeasures *
WithDimensions *;
```

Компоненты этого оператора IncludeModel:

* Название продукта данных: `Sales Performance Data`

* Пространство продуктов данных: `Sales Analysis Space`

* Таблицы: `Transactions` и `Products`

* Поля: все

* Меры и измерения: все

Обе таблицы загружены со своими связями. Все меры и измерения в семантической модели появятся в качестве основных элементов в приложении.

## Пример 2 – Загрузка определенных таблиц, мер и измерений

[](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/ScriptRegularStatements/IncludeModel.htm)

#### Загрузить скрипт

В этом примере загружаются определенные таблицы и их связи из продукта данных и его семантической модели. В нем используются подстановочные знаки (\*) для загрузки всех полей из указанных таблиц. Конкретные меры и измерения определяются как основные элементы, вместо автоматического определения всех мер и измерений как основных элементов.

```
IncludeModel [Customer Analytics] FromSpace [sales]
WithTables 
    Table [Customers] Fields * Connection [sales:DataFiles],
    Table [Orders] Fields * Connection [sales:DataFiles]
WithMeasures [Total Revenue], [Customer Count]
WithDimensions [Customer Name];
```

Компоненты этого оператора IncludeModel:

* Название продукта данных: `Customer Analytics`

* Пространство продуктов данных: `sales`

* Таблицы: `Customers` и `Orders`

* Поля: все

* Меры: `Total Revenue` и `Customer Count`

* Размеры: `Customer Name`

Обе таблицы загружены со своими связями. Каждая конкретная мера и каждое измерение из семантической модели появятся в качестве основных элементов в приложении.

## Пример 3 – Загрузка определенных таблиц, а также всех мер и измерений (набор данных находится в среде)

[](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/ScriptRegularStatements/IncludeModel.htm)

#### Загрузить скрипт

В этом примере загружаются определенные таблицы и связи их семантической модели из продукта данных, расположенного в пространстве данных, содержащемся в среде (см. [Синхронизация и управление средами](https://help.qlik.com/ru-RU/cloud-services/Subsystems/Hub/Content/Sense_Hub/Admin/mc-administer-environments.htm)). Также используются подстановочные знаки (\*) для загрузки всех полей из указанных таблиц, и все меры и измерения в семантической модели должны быть определены как основные элементы в приложении.

```
IncludeModel [Sales Performance Data]
    InEnvironment 'Production'
    FromSpace [Sales Analysis Space]
WithTables
    Table [Transactions] Fields * Connection [Sales Analysis Space:DataFiles],
    Table [Products] Fields * Connection [Sales Analysis Space:DataFiles]
WithMeasures *
WithDimensions *;
```

Компоненты этого оператора IncludeModel:

* Название продукта данных: `Sales Performance Data`

* Среда продукта данных: `Production`

* Пространство продуктов данных: `Sales Analysis Space`

* Таблицы: `Transactions` и `Products`

* Поля: все

* Меры и измерения: все

Обе таблицы загружены со своими связями. Все меры и измерения в семантической модели появятся в качестве основных элементов в приложении.

## IncludeModel ограничения скрипта

Синтаксис знака подстановки WithTables: \* не поддерживается. Необходимо явно перечислить таблицы.

[Семантические модели в продуктах данных](https://help.qlik.com/ru-RU/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/DataProducts/semantic-models-in-data-products.htm)

[Использование продуктов данных в приложениях](https://help.qlik.com/ru-RU/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/DataProducts/consuming-data-products-apps.htm)

[Каталог данных](https://help.qlik.com/ru-RU/cloud-services/Subsystems/Hub/Content/Sense_Hub/LoadData/data-catalog.htm)