IncludeModel

Последнее обновление: 2026-11-10

Инструкция 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, FromCurrentSpace, or FromPersonalSpace	Ключевые слова, определяющие пространство, из которого загружается продукт данных. При необходимости используйте один из следующих вариантов. Если все эти параметры ключевых слов опущены, оператор IncludeModel выполняет поиск продукта данных в вашем личном пространстве. FromSpace: Загрузить продукт данных, расположенный в пространстве, указанном с помощью data_product_space. FromCurrentSpace: Загрузить продукт данных, расположенный в текущем пространстве. FromPersonalSpace: Загрузите продукт данных, расположенный в вашем личном пространстве.
data_product_space	Указывает пространство продукта данных, который вы хотите загрузить, если вы используете FromSpace для явного указания конкретного пространства, из которого требуется выполнить загрузку. Это неприменимо, если вы используете FromPersonalSpace или FromCurrentSpace. Соблюдайте правила использования кавычек, описанные в Использование кавычек в скрипте. Примеры: MyAnalyticsSpace "My Analytics Space" [My Analytics Space]
InEnvironment	Ключевое слово, указывающее на использование продукта данных в среде, указанной с помощью environment_name. Не требуется, если продукт данных не находится в среде.
environment_name	Название среды, если применимо, содержащей продукт данных, который вы хотите загрузить. Соблюдайте правила использования кавычек, описанные в Использование кавычек в скрипте. Примеры: Production [Production Environment] "Production Environment"
WithTables	Ключевое слово, указывающее на использование таблиц, определенных в последующих операторах Table.
Table	Ключевое слово, указывающее на использование таблицы. Загружает по одной таблице на каждый оператор Table.
table_name	Указывает имя таблицы, используемой в модели данных. Соблюдайте правила использования кавычек, описанные в Использование кавычек в скрипте. Примеры: MyDataTable [My Data Table] "My Data Table"
Fields	Ключевое слово, предписывающее использовать указанные поля (fieldlist) из таблицы для интеграции в модель данных.
fieldlist	Список полей таблицы, на которую ссылается предшествующий оператор Table. Вы можете использовать *, чтобы использовать все поля таблицы, или указать список конкретных полей через запятую. Примеры: Amount, Quantity, Region [Amount], [Quantity], [Region]
Connection	Ключевое слово, определяющее использование набора данных, указанного в dataset_connection.
dataset_connection	Подключение, которое может загрузить набор данных, содержащий таблицу, на которую указывает ссылка. В зависимости от местоположения подключения используйте один из следующих форматов: environment:space:connection — используется для файлов, расположенных внутри сред (контейнеров для данных, синхронизируемых между Qlik Cloud и Qlik Talend Cloud). Окружения связаны с пространствами (в частности, с пространствами данных). Для получения дополнительной информации о средах, см. Синхронизация и управление средами. space:connection — Используется для подключений с пространством в качестве контейнера хранилища верхнего уровня или в той же среде, что и загружающее приложение. Это могут быть подключения, расположенные в общих, управляемых пространствах или пространствах данных. Например, для набора данных, хранящегося локально в Qlik Cloud (подключение DataFiles) и расположенного в пространстве с именем Sales Analysis, следует использовать следующее: Sales Analysis:DataFiles connection — Только имя подключения. Это относится к подключениям, расположенным в вашем личном пространстве. В этом случае подключение будет просто: DataFiles Примеры: [CustomerOrders:DataFiles] [SalesData2026:SnowflakeSales]
WithMeasures	Ключевое слово, предписывающее преобразовать указанные меры из продукта данных (measurelist) в основные меры.
measurelist	Список мер из семантической модели продукта данных для преобразования в мастер-меры. Вы можете использовать *, чтобы преобразовать все показатели, или указать список конкретных показателей через запятую. Пример: [Sales], [Total Quantity], [Cost]
WithDimensions	Ключевое слово, предписывающее преобразовать указанные измерения из продукта данных (dimensionlist) в мастер-измерения.
dimensionlist	Список измерений из семантической модели продукта данных для преобразования в мастер-измерения. Вы можете использовать *, чтобы преобразовать все измерения, или указать список конкретных измерений через запятую. Пример: [Product Name], [Region], [Customer]

замечания

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

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

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

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

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

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

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

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

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

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

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

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

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

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 – Загрузка определенных таблиц, мер и измерений

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

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 – Загрузка определенных таблиц, а также всех мер и измерений (набор данных находится в среде)

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

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: * не поддерживается. Необходимо явно перечислить таблицы.

Семантические модели в продуктах данных

Использование продуктов данных в приложениях

Каталог данных

Помогла ли вам эта страница?

Если вы обнаружили какую-либо проблему на этой странице или с ее содержанием — будь то опечатка, пропущенный шаг или техническая ошибка, сообщите нам об этом!

Оставьте свой отзыв здесь