IncludeModel

Ultimo aggiornamento: 2026-11-03

L'istruzione IncludeModel carica un prodotto dati e il relativo modello semantico, incluse tabelle, relazioni, misure e dimensioni. Le misure e le dimensioni del modello semantico appaiono automaticamente come voci principali nell'applicazione.

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]

Argomenti e parole chiave
Argomento o parola chiave	Descrizione
data_product_name	Il nome del prodotto dati da caricare.
FromSpace, FromCurrentSpace, or FromPersonalSpace	Parole chiave che specificano lo spazio da cui caricare il prodotto dati. Utilizzare una delle seguenti opzioni in base alle esigenze. Se tutte queste opzioni di parole chiave vengono omesse, l'istruzione IncludeModel cerca il prodotto dati nel tuo spazio personale. FromSpace: Carica il data product situato nello spazio specificato con data_product_space. FromCurrentSpace: Carica il data product situato nello spazio corrente. FromPersonalSpace: Carica il prodotto dati situato nel tuo spazio personale.
data_product_space	Specifica lo spazio del prodotto dati che si desidera caricare, se si utilizza FromSpace per specificare esplicitamente un particolare spazio da cui caricare. Questo non è applicabile se si utilizza FromPersonalSpace o FromCurrentSpace. Seguire le convenzioni per l'uso delle virgolette documentate all'indirizzo Uso delle virgolette nello script. Esempi: MyAnalyticsSpace "My Analytics Space" [My Analytics Space]
InEnvironment	Parola chiave che specifica di utilizzare il prodotto dati nell'ambiente specificato con environment_name. Non richiesto se il data product non si trova in un ambiente.
environment_name	Il nome dell'ambiente, se applicabile, contenente il prodotto dati che desideri caricare. Seguire le convenzioni per l'uso delle virgolette documentate all'indirizzo Uso delle virgolette nello script. Esempi: Production [Production Environment] "Production Environment"
WithTables	Parola chiave che specifica di utilizzare le tabelle definite nelle successive istruzioni Table.
Table	Parola chiave che specifica l'uso di una tabella. Carica una tabella per ogni istruzione Table.
table_name	Specifica il nome della tabella da utilizzare nel modello dati. Seguire le convenzioni per l'uso delle virgolette documentate all'indirizzo Uso delle virgolette nello script. Esempi: MyDataTable [My Data Table] "My Data Table"
Fields	Parola chiave che indica di utilizzare i campi specificati (fieldlist) della tabella da integrare nel modello dati.
fieldlist	Elenco dei campi della tabella a cui fa riferimento la precedente istruzione Table. È possibile utilizzare * per usare tutti i campi della tabella, oppure fornire un elenco separato da virgole di campi specifici. Esempi: Amount, Quantity, Region [Amount], [Quantity], [Region]
Connection	Parola chiave che specifica di utilizzare il dataset specificato in dataset_connection.
dataset_connection	Una connessione in grado di caricare il set di dati contenente la tabella a cui viene fatto riferimento. A seconda della posizione della connessione, utilizzare uno dei seguenti formati: environment:space:connection — Utilizzato per i file presenti all'interno di ambienti (contenitori per dati sincronizzati tra Qlik Cloud e Qlik Talend Cloud). Gli ambienti sono associati agli spazi (in particolare, spazi dati). Per ulteriori informazioni sugli ambienti, vedere Sincronizzazione e gestione di ambienti. space:connection — Utilizzato per le connessioni con uno spazio come contenitore di archiviazione di primo livello o nello stesso ambiente dell'applicazione di caricamento. Potrebbe trattarsi di connessioni situate in spazi condivisi, gestiti o spazi dati. Ad esempio, per un dataset memorizzato localmente all'interno di Qlik Cloud (connessione DataFiles), situato in uno spazio denominato Sales Analysis, si utilizzerebbe quanto segue: Sales Analysis:DataFiles connection — Solo nome della connessione. Si riferisce alle connessioni presenti nel tuo spazio personale. In questo caso, la connessione sarebbe semplicemente: DataFiles Esempi: [CustomerOrders:DataFiles] [SalesData2026:SnowflakeSales]
WithMeasures	Parola chiave che indica di convertire le misure specificate dal prodotto di dati (measurelist) in misure master.
measurelist	Elenco delle misure del modello semantico del data product da convertire in misure master. È possibile utilizzare * per convertire tutte le misure, oppure fornire un elenco separato da virgole di misure specifiche. Esempio: [Sales], [Total Quantity], [Cost]
WithDimensions	Parola chiave che indica di convertire le dimensioni specificate dal prodotto dati (dimensionlist) in dimensioni master.
dimensionlist	Elenco delle dimensioni del modello semantico del data product da convertire in dimensioni master. È possibile utilizzare * per convertire tutte le dimensioni, oppure fornire un elenco separato da virgole di dimensioni specifiche. Esempio: [Product Name], [Region], [Customer]

osservazioni

L'istruzione IncludeModel viene solitamente generata automaticamente dal catalogo dati quando si sceglie di caricare un prodotto dati con il suo modello semantico. È inoltre possibile scrivere l'istruzione manualmente o modificare l'istruzione generata per personalizzare quali campi, misure e dimensioni includere.

Le relazioni definite nel modello semantico vengono applicate automaticamente alle tabelle caricate, creando associazioni nel tuo modello dati.

Le operazioni per le misure e le dimensioni vengono applicate al termine del caricamento dei dati dopo che le tabelle e i campi sono stati caricati. Se il caricamento non riesce prima di tale fase, non viene applicata alcuna operazione di misura o dimensione.

È necessario disporre dell'autorizzazione Può consumare dati o Può visualizzare nello spazio contenente il data product per utilizzare l'istruzione IncludeModel.

Proprietà delle voci principali

La maggior parte degli attributi degli elementi master ereditati dai modelli semantici è di sola lettura nell'applicazione consumer. Alcuni altri attributi delle voci principali, come quelli relativi alle visualizzazioni, possono ancora essere modificati all'interno dell'applicazione.

Il comportamento di sola lettura si applica solo all'interfaccia utente—è possibile impostare diverse proprietà della voce principale tramite API:

Proprietà configurabili nel modello semantico ma di sola lettura nell'interfaccia utente dell'applicazione consumer. Questo include titolo, descrizione e tag.
Proprietà che non sono configurate nel modello semantico e non sono esposte nell'interfaccia utente dell'applicazione consumer.

Le modifiche alle proprietà definite dal modello semantico verranno sovrascritte quando l'applicazione viene ricaricata.

Eliminazione elemento master

In un'applicazione non pubblicata, è possibile eliminare una voce principale ereditata, ma ricompare al ricaricamento successivo se vi si fa ancora riferimento nello script IncludeModel. Per rimuoverlo definitivamente, rimuovilo prima dallo script. È anche possibile duplicare una voce principale ereditata. Il duplicare è una normale voce principale dell'applicazione ed è completamente modificabile.

Esempio 1 – Caricare tabelle specifiche, insieme a tutte le misure e le dimensioni

Questo esempio carica tabelle specifiche, e le relative relazioni, dal data product e dal suo modello semantico. Utilizza inoltre caratteri jolly (*) per caricare tutti i campi dalle tabelle specifiche e prevede che tutte le misure e le dimensioni nel modello semantico debbano essere definite come voci master nell'applicazione.

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

I componenti di questa istruzione IncludeModel sono:

Nome del prodotto dati: Sales Performance Data
Spazio del prodotto dati: Sales Analysis Space
Tabelle: Transactions e Products
Campi: tutti
Misure e dimensioni: tutte

Le due tabelle vengono caricate con le relative relazioni. Tutte le misure e le dimensioni nel modello semantico appariranno come voci principali nell'applicazione.

Esempio 2 – Caricare tabelle, misure e dimensioni specifiche

Questo esempio carica tabelle specifiche, e le relative relazioni, dal data product e dal suo modello semantico. Utilizza i caratteri jolly (*) per caricare tutti i campi dalle tabelle specifiche. Misure e dimensioni specifiche vengono definite come elementi master, anziché definire automaticamente tutte le misure e le dimensioni come elementi master.

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

I componenti di questa istruzione IncludeModel sono:

Nome del prodotto dati: Customer Analytics
Spazio del prodotto dati: sales
Tabelle: Customers e Orders
Campi: tutti
Misure: Total Revenue e Customer Count
Dimensioni: Customer Name

Le due tabelle vengono caricate con le relative relazioni. Ciascuna delle misure e delle dimensioni specifiche del modello semantico apparirà come voce principale nell'applicazione.

Esempio 3 – Caricare tabelle specifiche, insieme a tutte le misure e dimensioni (dataset situato nell'ambiente)

Questo esempio carica tabelle specifiche e le relative relazioni del modello semantico da un prodotto dati situato in uno spazio dati contenuto all'interno di un ambiente (vedere Sincronizzazione e gestione di ambienti). Utilizza inoltre caratteri jolly (*) per caricare tutti i campi dalle tabelle specifiche e prevede che tutte le misure e le dimensioni nel modello semantico debbano essere definite come voci master nell'applicazione.

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

I componenti di questa istruzione IncludeModel sono:

Nome del prodotto dati: Sales Performance Data
Ambiente del prodotto dati: Production
Spazio del prodotto dati: Sales Analysis Space
Tabelle: Transactions e Products
Campi: tutti
Misure e dimensioni: tutte

Le due tabelle vengono caricate con le relative relazioni. Tutte le misure e le dimensioni nel modello semantico appariranno come voci principali nell'applicazione.

IncludeModel limitazioni dello script

La sintassi del carattere jolly WithTables: * non è supportata. È necessario elencare esplicitamente le tabelle.

Modelli semantici nei prodotti dati

Consumare prodotti di dati nelle applicazioni

Catalogo dati

Hai trovato utile questa pagina?

Se riscontri problemi con questa pagina o con il suo contenuto – un errore di battitura, un passaggio mancante o un errore tecnico – ti pregiamo di farcelo sapere!

Lascia qui il tuo feedback