IncludeModel

Letzte Aktualisierung: 2026-11-03

Die Anweisung IncludeModel lädt ein Datenprodukt und dessen semantisches Modell, einschließlich Tabellen, Beziehungen, Measures und Dimensionen. Kennzahlen und Dimensionen aus dem semantischen Modell erscheinen automatisch als Master-Elemente in der Anwendung.

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]

Argumente und Schlüsselwörter
Argument oder Schlüsselwort	Beschreibung
data_product_name	Der Name des zu ladenden Datenprodukts.
FromSpace, FromCurrentSpace, or FromPersonalSpace	Schlüsselwörter, die den Space angeben, aus dem das Datenprodukt geladen werden soll. Verwenden Sie nach Bedarf eine der folgenden Optionen. Wenn alle diese Schlüsselwortoptionen weggelassen werden, sucht die IncludeModel-Anweisung nach dem Datenprodukt in Ihrem persönlichen Bereich. FromSpace: Lädt das Datenprodukt, das sich in dem mit data_product_space angegebenen Space befindet. FromCurrentSpace: Laden Sie das im aktuellen Space befindliche Datenprodukt. FromPersonalSpace: Laden Sie das in Ihrem persönlichen Bereich befindliche Datenprodukt.
data_product_space	Gibt den Space des Datenprodukts an, das Sie laden möchten, wenn Sie FromSpace verwenden, um explizit einen bestimmten Space anzugeben, aus dem geladen werden soll. Dies gilt nicht, wenn Sie FromPersonalSpace oder FromCurrentSpace verwenden. Befolgen Sie die unter Anführungszeichen im Skript verwenden dokumentierten Konventionen für Anführungszeichen. Beispiele: MyAnalyticsSpace "My Analytics Space" [My Analytics Space]
InEnvironment	Schlüsselwort, das angibt, dass das Datenprodukt in der mit environment_name angegebenen Umgebung verwendet werden soll. Nicht erforderlich, wenn sich das Datenprodukt nicht in einer Umgebung befindet.
environment_name	Der Name der Umgebung, sofern zutreffend, die das Datenprodukt enthält, das Sie laden möchten. Befolgen Sie die unter Anführungszeichen im Skript verwenden dokumentierten Konventionen für Anführungszeichen. Beispiele: Production [Production Environment] "Production Environment"
WithTables	Schlüsselwort, das angibt, dass die in nachfolgenden Table-Anweisungen definierten Tabellen verwendet werden sollen.
Table	Schlüsselwort, das die Verwendung einer Tabelle angibt. Lädt eine Tabelle pro Table-Anweisung.
table_name	Gibt den Namen der Tabelle an, die im Datenmodell verwendet werden soll. Befolgen Sie die unter Anführungszeichen im Skript verwenden dokumentierten Konventionen für Anführungszeichen. Beispiele: MyDataTable [My Data Table] "My Data Table"
Fields	Schlüsselwort, das anweist, die angegebenen Felder (fieldlist) aus der Tabelle zu verwenden, um sie in das Datenmodell zu integrieren.
fieldlist	Liste der Felder aus der Tabelle, auf die in der vorangehenden Table-Anweisung verwiesen wird. Sie können * verwenden, um alle Felder aus der Tabelle zu verwenden, oder eine kommagetrennte Liste bestimmter Felder angeben. Beispiele: Amount, Quantity, Region [Amount], [Quantity], [Region]
Connection	Schlüsselwort, das angibt, den in dataset_connection angegebenen Datensatz zu verwenden.
dataset_connection	Eine Verbindung, die das Dataset laden kann, das die referenzierte Tabelle enthält. Je nach Standort der Verbindung verwenden Sie eines der folgenden Formate: environment:space:connection — Wird für Dateien verwendet, die sich in Umgebungen befinden (Container für Daten, die zwischen Qlik Cloud und Qlik Talend Cloud synchronisiert werden). Umgebungen sind Spaces zugeordnet (insbesondere Data Spaces). Weitere Informationen zu Umgebungen finden Sie unter Synchronisieren und Verwalten von Umgebungen. space:connection — Wird für Verbindungen mit einem Space als Speicher-Sammelbox auf oberster Ebene oder in derselben Umgebung wie die Ladeanwendung verwendet. Dies können Verbindungen sein, die sich in freigegebenen, verwalteten oder Datenbereichen befinden. Für einen Datensatz, der lokal in Qlik Cloud (DataFiles Verbindung) gespeichert ist und sich in einem Space namens Sales Analysis befindet, verwenden Sie beispielsweise Folgendes: Sales Analysis:DataFiles connection — Nur Verbindungsname. Dies bezieht sich auf Verbindungen, die sich in Ihrem persönlichen Bereich befinden. In diesem Fall wäre die Verbindung einfach: DataFiles Beispiele: [CustomerOrders:DataFiles] [SalesData2026:SnowflakeSales]
WithMeasures	Schlüsselwort, das anweist, die angegebenen Kennzahlen aus dem Datenprodukt (measurelist) in Master-Kennzahlen zu konvertieren.
measurelist	Liste der Kennzahlen aus dem semantischen Modell des Datenprodukts, die in Master-Kennzahlen umgewandelt werden sollen. Sie können * verwenden, um alle Kennzahlen zu konvertieren, oder eine kommagetrennte Liste bestimmter Kennzahlen angeben. Beispiel: [Sales], [Total Quantity], [Cost]
WithDimensions	Schlüsselwort, das anweist, die angegebenen Dimensionen aus dem Datenprodukt (dimensionlist) in Master-Dimensionen zu konvertieren.
dimensionlist	Liste der Dimensionen aus dem semantischen Modell des Datenprodukts, die in Master-Dimensionen umgewandelt werden sollen. Sie können * verwenden, um alle Dimensionen zu konvertieren, oder eine kommagetrennte Liste bestimmter Dimensionen angeben. Beispiel: [Product Name], [Region], [Customer]

Remarks

Die Anweisung IncludeModel wird typischerweise automatisch vom Datenkatalog generiert, wenn Sie auswählen, ein Datenprodukt mit seinem semantischen Modell zu laden. Sie können die Anweisung auch manuell schreiben oder die generierte Anweisung bearbeiten, um anzupassen, welche Felder, Kennzahlen und Dimensionen enthalten sind.

Im semantischen Modell definierte Beziehungen werden automatisch auf die geladenen Tabellen angewendet, wodurch Assoziationen in Ihrem Datenmodell erstellt werden.

Operationen für Kennzahlen und Dimensionen werden am Ende des Datenladevorgangs angewendet, nachdem die Tabellen und Felder geladen wurden. Wenn der Ladevorgang vor dieser Phase fehlschlägt, werden keine Kennzahlen- oder Dimensionsoperationen angewendet.

Sie müssen im Space, der das Datenprodukt enthält, über die Berechtigung Kann Daten verbrauchen oder Kann anzeigen verfügen, um die Anweisung IncludeModel zu verwenden.

Master-Element-Eigenschaften

Die meisten Attribute von Master-Elementen, die von semantischen Modellen geerbt wurden, sind in der konsumierenden Anwendung schreibgeschützt. Einige andere Master-Element-Attribute, wie beispielsweise jene, die sich auf Visualisierungen beziehen, können weiterhin innerhalb der Anwendung bearbeitet werden.

Das schreibgeschützte Verhalten gilt nur für die Benutzeroberfläche – Sie können eine Reihe von Master-Element-Eigenschaften über die API festlegen:

Eigenschaften, die im semantischen Modell konfigurierbar, aber in der Benutzeroberfläche der konsumierenden Anwendung schreibgeschützt sind. Dies umfasst Titel, Beschreibung und Tags.
Eigenschaften, die nicht im semantischen Modell konfiguriert sind und in der Benutzeroberfläche der nutzenden Anwendung nicht bereitgestellt werden.

Änderungen an Eigenschaften, die durch das semantische Modell definiert sind, werden beim Neuladen der Anwendung überschrieben.

Löschen von Master-Elementen

In einer unveröffentlichten Anwendung können Sie ein vererbtes Master-Element löschen, aber es wird beim nächsten Laden wieder angezeigt, wenn im IncludeModel-Skript weiterhin darauf verwiesen wird. Um es dauerhaft zu entfernen, entfernen Sie es zuerst aus dem Skript. Sie können auch ein vererbtes Master-Element duplizieren. Das durch Duplizieren erstellte Element ist ein gewöhnliches Anwendungs-Master-Element und ist vollständig bearbeitbar.

Beispiel 1 – Bestimmte Tabellen zusammen mit allen Kennzahlen und Dimensionen laden

Dieses Beispiel lädt bestimmte Tabellen und deren Beziehungen aus dem Datenprodukt und seinem semantischen Modell. Es verwendet außerdem Platzhalter (*), um alle Felder aus den spezifischen Tabellen zu laden, und sieht vor, dass alle Kennzahlen und Dimensionen im semantischen Modell als Master-Elemente in der Anwendung definiert werden sollen.

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

Die Komponenten dieser IncludeModel-Anweisung sind:

Datenproduktname: Sales Performance Data
Datenproduktbereich: Sales Analysis Space
Tabellen: Transactions und Products
Felder: alle
Kennzahlen und Dimensionen: alle

Die beiden Tabellen werden mit ihren Beziehungen geladen. Alle Kennzahlen und Dimensionen im semantischen Modell erscheinen als Master-Elemente in der Anwendung.

Beispiel 2 – Bestimmte Tabellen, Measures und Dimensionen laden

Dieses Beispiel lädt bestimmte Tabellen und deren Beziehungen aus dem Datenprodukt und seinem semantischen Modell. Es verwendet Platzhalter (*), um alle Felder aus den spezifischen Tabellen zu laden. Bestimmte Kennzahlen und Dimensionen werden als Master-Elemente definiert, anstatt automatisch alle Kennzahlen und Dimensionen als Master-Elemente zu definieren.

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

Die Komponenten dieser IncludeModel-Anweisung sind:

Datenproduktname: Customer Analytics
Datenproduktbereich: sales
Tabellen: Customers und Orders
Felder: alle
Kennzahlen: Total Revenue und Customer Count
Abmessungen: Customer Name

Die beiden Tabellen werden mit ihren Beziehungen geladen. Jede der spezifischen Kennzahlen und Dimensionen aus dem semantischen Modell erscheint als Master-Element in der Anwendung.

Beispiel 3 – Bestimmte Tabellen zusammen mit allen Measures und Dimensionen laden (Dataset befindet sich in der Umgebung)

Dieses Beispiel lädt bestimmte Tabellen und deren Beziehungen des semantischen Modells aus einem Datenprodukt, das sich in einem Datenbereich innerhalb einer Umgebung befindet (siehe Synchronisieren und Verwalten von Umgebungen). Es verwendet außerdem Platzhalter (*), um alle Felder aus den spezifischen Tabellen zu laden, und sieht vor, dass alle Kennzahlen und Dimensionen im semantischen Modell als Master-Elemente in der Anwendung definiert werden sollen.

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

Die Komponenten dieser IncludeModel-Anweisung sind:

Datenproduktname: Sales Performance Data
Datenproduktumgebung: Production
Datenproduktbereich: Sales Analysis Space
Tabellen: Transactions und Products
Felder: alle
Kennzahlen und Dimensionen: alle

Die beiden Tabellen werden mit ihren Beziehungen geladen. Alle Kennzahlen und Dimensionen im semantischen Modell erscheinen als Master-Elemente in der Anwendung.

IncludeModel Skript-Einschränkungen

Die WithTables: *-Wildcard-Syntax wird nicht unterstützt. Sie müssen Tabellen explizit auflisten.

Semantische Modelle in Datenprodukten

Verwenden von Datenprodukten in Anwendungen

Datenkatalog

Hat diese Seite Ihnen geholfen?

Wenn Sie ein Problem mit dieser Seite oder ihrem Inhalt feststellen, sei es ein Tippfehler, ein ausgelassener Schritt oder ein technischer Fehler, informieren Sie uns bitte!

Geben Sie hier Ihr Feedback ab