Consumare prodotti di dati nelle applicazioni

Gli sviluppatori di analitica possono caricare prodotti di dati, con i rispettivi modelli semantici, nelle applicazioni di analitica utilizzando il catalogo dati. Il catalogo dati genera il script necessario e crea elementi master per misure e dimensioni.

Quando consumi un data product, il catalogo dati genera un'istruzione di script IncludeModel che carica le tabelle, le relazioni, le misure e le dimensioni selezionate nella tua applicazione. Le misure e le dimensioni del modello semantico appaiono automaticamente come voci principali, pronte per l'uso nelle visualizzazioni.

Prerequisiti

Per consumare un data product e il suo modello semantico, è necessario:

Autorizzazioni

Per consumare il modello semantico dei prodotti dati negli spazi condivisi, gestiti e di dati, è necessaria l'autorizzazione Può consumare dati o Può visualizzare nello spazio contenente il prodotto dati.

Per tutti i dettagli, vedere Ruoli e autorizzazioni per i prodotti dati.

Dataset accessibili

È necessario avere accesso ai set di dati, nonché alle connessioni ai dati sottostanti, inclusi nel modello semantico.

Nome univoco del prodotto dati

Il prodotto dati deve avere un nome univoco all'interno dello spazio. Se un'applicazione contiene già un prodotto dati con lo stesso nome, il caricamento del modello semantico non riesce.

Consumo di un data product e di un modello semantico tramite il data product

È possibile creare un'app di analisi direttamente da un prodotto dati. È possibile perfezionare cosa utilizzare dal prodotto dati e dal suo modello semantico: dataset, campi e voci master.

1. Apri il prodotto dati, selezionandone uno dal data marketplace o esplorando il catalogo.

2. Nell'intestazione del nome del prodotto dati, fai clic su Usa in > Applicazione.

   

3. Nella finestra Crea una nuova applicazione, esaminare il modello semantico e i dati che verranno caricati.
4. Fare clic su Continua.

   Si apre la Editor caricamento dati dell'applicazione appena creata e si viene reindirizzati al catalogo dati. Il prodotto dati è selezionato per impostazione predefinita, ma è possibile esplorare, perfezionare la selezione ed esaminare i dati prima di caricarli nell'applicazione. Per ulteriori informazioni, vedere Consumo di un data product e di un modello semantico tramite Editor caricamento dati.

5. Quando sei pronto, fai clic su Carica dati.

Dopo il caricamento dei dati, è possibile iniziare ad aggiungere fogli e lavorare sull'applicazione oppure passare a Editor caricamento dati per esaminare e modificare lo script, se necessario. Le tabelle, le relazioni, le misure e le dimensioni del modello semantico sono ora disponibili per l'uso.

Per ulteriori informazioni sulla visualizzazione dei dati nei fogli, vedere Creazione di analisi e visualizzazione dei dati.

Consumo di un data product e di un modello semantico tramite Editor caricamento dati

Il catalogo dati fornisce un'interfaccia per esplorare e selezionare dati e informazioni sul modello semantico dai prodotti dati, anziché immettere manualmente script.

Per caricare un data product e il suo modello semantico:

1. Apri un'applicazione.
2. Fare clic su Editor caricamento dati nella barra di navigazione superiore.
3. Nel pannello a destra Aggiungi dati, fare clic su Aggiungi da Catalogo dati.
4. Si apre la finestra modale del catalogo dati, che mostra i dati disponibili, inclusi i prodotti di dati con modelli semantici.

   

Esplorazione dei prodotti dati

Il catalogo dati visualizza i prodotti dati che contengono modelli semantici. È possibile esplorare e cercare i prodotti di dati per nome, descrizione o tag.

Fare clic su un prodotto dati per visualizzare un riepilogo di ciò che verrà caricato nello script dell'applicazione, incluse tabelle, misure e dimensioni.

Se un set di dati nel modello semantico non è accessibile, viene contrassegnato con un indicatore di avviso. È comunque possibile utilizzare le misure e le dimensioni a esso correlate presenti nel modello semantico, ma qualsiasi set di dati inaccessibile, insieme ai relativi campi, è escluso.

Selezione e perfezionamento di un modello semantico

Dopo aver selezionato quale data product utilizzare, puoi perfezionare la selezione e scegliere con precisione quali componenti del modello semantico includere nella tua applicazione.

1. Posiziona il puntatore del mouse sul prodotto dati selezionato e fai clic su Perfeziona selezione.

   

   Sono disponibili tre nuove schede in cui è possibile navigare tra gli elementi del data product:

   • Tabelle/campi
   • Dimensioni
   • Misure
2. Utilizzare le caselle di controllo per perfezionare la selezione e scegliere quali set di dati, campi, misure e dimensioni includere.
Nota di suggerimento

Gli utenti avanzati possono attivare o disattivare Includi automaticamente gli elementi aggiunti al ricaricamento per controllare se i nuovi elementi vengono inclusi automaticamente quando il modello semantico cambia.

Quando abilitato, nuovi campi, misure e dimensioni aggiunti al modello semantico vengono aggiunti automaticamente al modello dati e alle voci principali durante la ricarica. Questo si applica solo se tutti i campi, le misure e le dimensioni sono rispettivamente selezionati.

3. Quando la selezione è pronta, fai clic su Inserisci script.

Lo script IncludeModel generato viene inserito nello script di caricamento e può essere visualizzato e modificato nell'Editor caricamento dati. Per caricare i dati nell'applicazione, fare clic su Carica dati.

Dopo il caricamento dei dati, è possibile iniziare ad aggiungere fogli e a lavorare sull'applicazione. Per ulteriori informazioni, vedere Creazione di analisi e visualizzazione dei dati.

Comprendere l'inclusione automatica

La funzionalità di inclusione automatica controlla come risponde l'applicazione quando il modello semantico cambia.

Quando l'inclusione automatica è abilitata per un tipo di componente, lo script generato utilizza un selettore con carattere jolly (*):

• Fields *: Include tutti i campi della tabella specificata.
• WithMeasures: *: Include tutte le misure come voci principali.
• WithDimensions: *: Include tutte le dimensioni come voci master.

Quando l'inclusione automatica è disabilitata, lo script elenca esplicitamente gli elementi selezionati. Ad esempio:

• WithMeasures [Total sales], [Total quantity]: include solo le misure specificate.
• WithDimensions [Region], [Product]: Include solo le dimensioni specificate.

L'inclusione automatica è consigliata per gli utenti avanzati per ridurre la manutenzione e garantire che l'applicazione benefici dei miglioramenti apportati al modello semantico. Disabilita l'inclusione automatica se hai bisogno di un controllo rigoroso su quali elementi vengono inclusi.

Comprendere lo script IncludeModel generato

I dati generano un'istruzione script IncludeModel che fa riferimento al modello semantico e specifica quali componenti caricare.

Script di esempio

IncludeModel [My Example Data Product] FromSpace [My Shared Space]
WithTables
  Table [dataset_dim_dateinfo] Fields * Connection [My Shared Space:DataFiles],
  Table [dataset_dim_customer] Fields * Connection [My Shared Space:DataFiles],
  Table [dataset_fact_transactions] Fields * Connection [My Shared Space:DataFiles],
  Table [dataset_dim_category] Fields * Connection [My Shared Space:DataFiles],
  Table [dataset_dim_sales_rep] Fields * Connection [My Shared Space:DataFiles]
WithMeasures *
WithDimensions *;

Parametri dello script:

• IncludeModel: Il nome del prodotto dati contenente il modello semantico.
• FromSpace: Specifica lo spazio contenente il prodotto dati.
• WithTables: Specifica quali tabelle includere.
• Table: Specifica una tabella da includere. È possibile includere istruzioni Table per ogni tabella che si desidera utilizzare, separate da virgole.
• Fields: Specifica quali campi includere dalla tabella specificata. Utilizzare * per tutti i campi o un elenco di campi separati da virgole.
• Connection: Specifica la posizione della tabella utilizzando il formato environment:space:connection, space:connection o connection.
• WithMeasures: Specifica quali misure includere come misure master. Utilizzare * per tutte le misure o per un elenco di nomi di misura specifici.
• WithDimensions: Specifica quali dimensioni includere come dimensioni master. Utilizzare * per tutte le dimensioni o un elenco di nomi di dimensione specifici.

È possibile modificare manualmente l'istruzione IncludeModel per regolare quali elementi includere o per passare tra le modalità di selezione con carattere jolly ed esplicita.

Per i dettagli completi sull'istruzione IncludeModel, vedere IncludeModel.

Denominazione di campi e tabelle

Quando un prodotto dati viene caricato in un'applicazione, i nomi dei campi e delle tabelle possono essere modificati automaticamente per evitare conflitti di denominazione e trasformare le relazioni in associazioni basate sui nomi in base ai pattern di analisi di Qlik.

• Campi con lo stesso nome senza relazione: Se due tabelle contengono un campo con lo stesso nome ma i campi non presentano una relazione, i nomi dei campi vengono qualificati automaticamente con il nome della rispettiva tabella (ad esempio, TableName.FieldName) per evitare un'associazione automatica non intenzionale nell'applicazione.
• Campi che hanno una relazione: Se i due campi hanno una relazione ma nomi diversi, vengono rinominati con lo stesso nome, il nome della relazione, quando vengono caricati in un'applicazione per formare un'associazione.

• Chiavi composte: per le chiavi composte, viene aggiunto un nuovo campo chiave alle tabelle coinvolte.

• Tabelle con lo stesso nome: se due tabelle hanno lo stesso nome, vengono rinominate automaticamente aggiungendo un suffisso numerico, ad esempio TableName_1, TableName_2 e così via.

Utilizzo delle voci principali ereditate

Quando si ricarica un'applicazione che include un'istruzione IncludeModel, le misure e le dimensioni del modello semantico appaiono automaticamente nel pannello delle voci principali.

Per utilizzare le voci master da un modello semantico:

1. Ricarica l'applicazione per caricare i dati dal modello semantico.
2. Aprire un foglio in modalità di modifica.
3. Nel pannello a sinistra, fare clic su Voci principali.
4. Le misure e le dimensioni del modello semantico compaiono nell'elenco con un indicatore del prodotto dati.

   

5. Trascina una misura principale o una dimensione su una visualizzazione per utilizzarla.

Gli elementi master ereditati dai modelli semantici visualizzano il nome e la descrizione del prodotto dati di origine. È possibile visualizzare l'espressione utilizzata dalla misura o dimensione posizionando il puntatore su di essa.

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.

Voci master e pubblicazione delle applicazioni

Quando un'applicazione viene pubblicata, le relative voci principali ereditate rimangono fisse alla versione del prodotto dati utilizzata al momento della pubblicazione dell'applicazione. La ricarica di un'applicazione pubblicata non crea, aggiorna o elimina voci master dal prodotto dati. Per utilizzare misure e dimensioni nuove o modificate, aggiornare l'applicazione e pubblicarla nuovamente.

Gestione degli aggiornamenti del modello semantico in un'applicazione

Se il modello semantico cambia dopo averlo utilizzato, è possibile aggiornare l'applicazione per riflettere le modifiche.

Se hai utilizzato la modalità di inclusione automatica con selettori con caratteri jolly, le nuove misure e dimensioni vengono incluse automaticamente. Se hai utilizzato la selezione esplicita, vengono caricati solo gli elementi originariamente selezionati.

Per aggiungere nuovi elementi dal modello semantico:

1. Avviare Editor caricamento dati.
2. Individua l'istruzione IncludeModel nel tuo script.
3. Modifica l'istruzione per aggiungere nuovi elementi o modificare i selettori in * per l'inclusione automatica.
4. Ricarica l'applicazione.

In alternativa, è possibile rimuovere l'istruzione IncludeModel esistente e utilizzare il catalogo dati per generarne una nuova con le selezioni aggiornate.

Consumo di data product in altri strumenti

In Script, è possibile consumare data product, ma le misure e le dimensioni vengono ignorate.

Quando si utilizzano data product in risorse diverse da applicazioni e script (come flussi di dati e ricette di tabelle), il data product funge da insieme di dataset attendibili tra cui scegliere. Questi strumenti utilizzano i set di dati come origini e il prodotto dati non viene visualizzato come nodo di origine nella derivazione.