IncludeModel

Ostatnia aktualizacja: 2026-11-03

Instrukcja IncludeModel ładuje produkt danych i jego model semantyczny, w tym tabele, relacje, miary i wymiary. Miary i wymiary z modelu semantycznego automatycznie pojawiają się jako elementy główne w aplikacji.

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]

Argumenty i słowa kluczowe
Argument lub słowo kluczowe	Opis
data_product_name	Nazwa produktu danych do załadowania.
FromSpace, FromCurrentSpace, or FromPersonalSpace	Słowa kluczowe określające przestrzeń, z której ma zostać załadowany produkt danych. Użyj jednej z poniższych opcji w zależności od potrzeb. Jeśli wszystkie te opcje słów kluczowych zostaną pominięte, instrukcja IncludeModel wyszukuje produkt danych w Twojej przestrzeni prywatnej. FromSpace: Załaduj produkt danych znajdujący się w przestrzeni określonej za pomocą data_product_space. FromCurrentSpace: Załaduj produkt danych znajdujący się w bieżącej przestrzeni. FromPersonalSpace: Załaduj produkt danych znajdujący się w Twojej przestrzeni prywatnej.
data_product_space	Określa przestrzeń produktu danych, który chcesz załadować, jeśli używasz FromSpace do jawnego określenia konkretnej przestrzeni, z której ma nastąpić ładowanie. Nie ma to zastosowania, jeśli używasz FromPersonalSpace lub FromCurrentSpace. Stosuj się do konwencji cytowania udokumentowanych w Stosowanie znaków cudzysłowu w skrypcie. Przykłady: MyAnalyticsSpace "My Analytics Space" [My Analytics Space]
InEnvironment	Słowo kluczowe określające użycie produktu danych w środowisku wskazanym za pomocą environment_name. Niewymagane, jeśli produkt danych nie znajduje się w środowisku.
environment_name	Nazwa środowiska, jeśli dotyczy, zawierającego produkt danych, który chcesz załadować. Stosuj się do konwencji cytowania udokumentowanych w Stosowanie znaków cudzysłowu w skrypcie. Przykłady: Production [Production Environment] "Production Environment"
WithTables	Słowo kluczowe określające użycie tabel zdefiniowanych w kolejnych instrukcjach Table.
Table	Słowo kluczowe określające użycie tabeli. Ładuje jedną tabelę na instrukcję Table.
table_name	Określa nazwę tabeli do użycia w modelu danych. Stosuj się do konwencji cytowania udokumentowanych w Stosowanie znaków cudzysłowu w skrypcie. Przykłady: MyDataTable [My Data Table] "My Data Table"
Fields	Słowo kluczowe nakazujące użycie określonych pól (fieldlist) z tabeli w celu integracji z modelem danych.
fieldlist	Lista pól z tabeli, do której odwołuje się poprzedzająca instrukcja Table. Możesz użyć *, aby wykorzystać wszystkie pola z tabeli, lub podać rozdzieloną przecinkami listę określonych pól. Przykłady: Amount, Quantity, Region [Amount], [Quantity], [Region]
Connection	Słowo kluczowe wskazujące na użycie zestawu danych określonego w dataset_connection.
dataset_connection	Połączenie, które może załadować zestaw danych zawierający tabelę, do której istnieje odwołanie. W zależności od lokalizacji połączenia użyj jednego z następujących formatów: environment:space:connection — Używane w przypadku plików znajdujących się w środowiskach (kontenerach na dane synchronizowane między Qlik Cloud a Qlik Talend Cloud). Środowiska są powiązane z przestrzeniami (w szczególności z przestrzeniami danych). Aby uzyskać więcej informacji na temat środowisk, zobacz Synchronizowanie i zarządzanie środowiskami. space:connection — Używane w przypadku połączeń z przestrzenią jako kontenerem pamięci masowej najwyższego poziomu lub w tym samym środowisku co aplikacja ładująca. Mogą to być połączenia znajdujące się w przestrzeniach współdzielonych, zarządzanych lub danych. Na przykład w przypadku zestawu danych przechowywanego lokalnie w Qlik Cloud (połączenie DataFiles), znajdującego się w przestrzeni o nazwie Sales Analysis, należy użyć następującego zapisu: Sales Analysis:DataFiles connection — Tylko nazwa połączenia. Dotyczy to połączeń znajdujących się w Twojej przestrzeni prywatnej. W tym przypadku połączenie byłoby po prostu: DataFiles Przykłady: [CustomerOrders:DataFiles] [SalesData2026:SnowflakeSales]
WithMeasures	Słowo kluczowe nakazujące konwersję określonych miar z produktu danych (measurelist) na miary główne.
measurelist	Lista miar z modelu semantycznego produktu danych do przekształcenia w miary główne. Możesz użyć *, aby przekonwertować wszystkie miary, lub podać rozdzieloną przecinkami listę określonych miar. Przykład: [Sales], [Total Quantity], [Cost]
WithDimensions	Słowo kluczowe nakazujące konwersję określonych wymiarów z produktu danych (dimensionlist) na wymiary główne.
dimensionlist	Lista wymiarów z modelu semantycznego produktu danych do przekształcenia w wymiary główne. Możesz użyć *, aby przekonwertować wszystkie wymiary, lub podać rozdzieloną przecinkami listę określonych wymiarów. Przykład: [Product Name], [Region], [Customer]

komentarze

Instrukcja IncludeModel jest zazwyczaj generowana automatycznie przez katalog danych, gdy wybierzesz załadowanie produktu danych z jego modelem semantycznym. Możesz także napisać instrukcję ręcznie lub edytować wygenerowaną instrukcję, aby dostosować, które pola, miary i wymiary mają zostać uwzględnione.

Relacje zdefiniowane w modelu semantycznym są automatycznie stosowane do załadowanych tabel, tworząc powiązania w Twoim modelu danych.

Operacje na miarach i wymiarach są stosowane na końcu ładowania danych, po załadowaniu tabel i pól. Jeśli ładowanie zakończy się niepowodzeniem przed tą fazą, żadne operacje na miarach ani wymiarach nie zostaną zastosowane.

Musisz mieć uprawnienie Może korzystać z danych lub Może wyświetlać w przestrzeni zawierającej produkt danych, aby użyć instrukcji IncludeModel.

Właściwości elementów głównych

Większość atrybutów elementów głównych odziedziczonych z modeli semantycznych jest tylko do odczytu w aplikacji konsumującej. Niektóre inne atrybuty elementu głównego, takie jak te powiązane z wizualizacjami, nadal można edytować w aplikacji.

Działanie tylko do odczytu dotyczy wyłącznie interfejsu użytkownika — za pomocą API można ustawić szereg właściwości elementu głównego:

Właściwości, które można konfigurować w modelu semantycznym, ale są tylko do odczytu w interfejsie użytkownika aplikacji konsumującej. Obejmuje to tytuł, opis i tagi.
Właściwości, które nie są skonfigurowane w modelu semantycznym i nie są wyeksponowane w interfejsie użytkownika aplikacji konsumującej.

Zmiany właściwości zdefiniowanych przez model semantyczny zostaną nadpisane po ponownym załadowaniu aplikacji.

Usuwanie elementu głównego

W nieopublikowanej aplikacji można usunąć odziedziczony element główny, ale pojawi się on ponownie przy następnym przeładowaniu, jeśli nadal istnieje do niego odwołanie w skrypcie IncludeModel. Aby trwale go usunąć, najpierw usuń go ze skryptu. Można także duplikować odziedziczony element główny. Duplikować to zwykły element główny aplikacji i jest w pełni edytowalny.

Przykład 1 – Ładowanie określonych tabel wraz ze wszystkimi miarami i wymiarami

Ten przykład ładuje określone tabele oraz ich relacje z produktu danych i jego modelu semantycznego. Używa również znaków wieloznacznych (*) do załadowania wszystkich pól z określonych tabel, a także zakłada, że wszystkie miary i wymiary w modelu semantycznym mają zostać zdefiniowane jako elementy główne w aplikacji.

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 *;

Elementy tej instrukcji IncludeModel to:

Nazwa produktu danych: Sales Performance Data
Przestrzeń produktu danych: Sales Analysis Space
Tabele: Transactions i Products
Pola: wszystkie
Miary i wymiary: wszystkie

Obie tabele są ładowane wraz ze swoimi relacjami. Wszystkie miary i wymiary w modelu semantycznym pojawią się jako elementy główne w aplikacji.

Przykład 2 – Ładowanie określonych tabel, miar i wymiarów

Ten przykład ładuje określone tabele oraz ich relacje z produktu danych i jego modelu semantycznego. Używa symboli wieloznacznych (*), aby załadować wszystkie pola z określonych tabel. Określone miary i wymiary są definiowane jako elementy główne, zamiast automatycznego definiowania wszystkich miar i wymiarów jako elementów głównych.

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];

Elementy tej instrukcji IncludeModel to:

Nazwa produktu danych: Customer Analytics
Przestrzeń produktu danych: sales
Tabele: Customers i Orders
Pola: wszystkie
Miary: Total Revenue i Customer Count
Wymiary: Customer Name

Obie tabele są ładowane wraz ze swoimi relacjami. Każda z określonych miar i każdy z określonych wymiarów z modelu semantycznego pojawią się jako elementy główne w aplikacji.

Przykład 3 – Ładowanie określonych tabel wraz ze wszystkimi miarami i wymiarami (zestaw danych zlokalizowany w środowisku)

Ten przykład ładuje określone tabele oraz ich relacje w modelu semantycznym z produktu danych znajdującego się w przestrzeni danych zawartej w środowisku (zobacz Synchronizowanie i zarządzanie środowiskami). Używa również znaków wieloznacznych (*) do załadowania wszystkich pól z określonych tabel, a także zakłada, że wszystkie miary i wymiary w modelu semantycznym mają zostać zdefiniowane jako elementy główne w aplikacji.

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 *;

Elementy tej instrukcji IncludeModel to:

Nazwa produktu danych: Sales Performance Data
Środowisko produktu danych: Production
Przestrzeń produktu danych: Sales Analysis Space
Tabele: Transactions i Products
Pola: wszystkie
Miary i wymiary: wszystkie

Obie tabele są ładowane wraz ze swoimi relacjami. Wszystkie miary i wymiary w modelu semantycznym pojawią się jako elementy główne w aplikacji.

IncludeModel ograniczenia skryptu

Składnia symbolu wieloznacznego WithTables: * nie jest obsługiwana. Należy jawnie wymienić tabele.

Modele semantyczne w produktach danych

Korzystanie z produktów danych w aplikacjach

Katalog danych

Czy ta strona była pomocna?

Jeżeli natkniesz się na problemy z tą stroną lub jej zawartością — literówkę, brakujący krok lub błąd techniczny — daj nam znać!

Przekaż tu opinię