Utilizzo dei caricamenti inline per caricare i dati
Digitare manualmente i dati nello script per definire una tabella inline, che è possibile caricare in un'app. In Editor caricamento dati e Script è possibile utilizzare i caricamenti inline.
Le tabelle inline vengono create digitando manualmente i dati nello script, anziché creando una connessione a file e database. Utilizzare la sintassi richiesta per indicare che il testo dello script deve essere interpretato come dati inline. I dati aggiunti con i caricamenti inline saranno inclusi nell'app qualora questa venga esportata. È possibile visualizzare e modificare le tabelle inline nello script di caricamento.
Un caricamento inline di base crea una tabella e inserisce i campi e i record dati.
Esempio di sintassi di base
Il seguente script contiene un semplice caricamento inline.
Per il caricamento inline riportato sopra viene utilizzata la seguente sintassi:
Load * Inline indica a Qlik Sense di caricare tutti i campi dalla tabella inline che segue.
MyTable: definisce il nome della tabella. È possibile accedere all'elenco di tabelle nell'app da Sistema di visualizzazione modello dati e da altre aree.
Parentesi quadre racchiudono i dati.
La prima riga dell'istruzione LOAD definisce i campi dati.
Le virgole separano i campi dati e i record.
Un punto e virgola chiude l'istruzione LOAD.
Caricamento di una tabella inline
Procedere come indicato di seguito:
In un'app, aprire Editor caricamento dati.
In una nuova riga, definire la tabella utilizzando la sintassi richiesta.
I caricamenti inline possono essere utili in una serie di casi di utilizzo:
Per l'amministrazione e la modifica dei dati senza bisogno di connettersi a sorgenti esterne.
Per l'integrazione dei dati nel modello dati. Per esempio, si potrebbe aggiungere una tabella aggiuntiva a un modello dati originato principalmente da sorgenti di database.
Per aggiungere dati che non si desidera caricare continuamente da sorgenti esterne. In questo modo, è possibile risparmiare tempo se per esempio si sa già che una sorgente dati potrebbe cambiare successivamente, ma che i valori dei dati rimarranno gli stessi.
Per consentire di copiare e incollare facilmente i contenuti nello script da altri file. Per esempio, i file .csv o le tabelle dai documenti di elaborazione testi.
Per creare script di prova che è possibile copiare e incollare velocemente.
Panoramica della sintassi
Denominazione della tabella
È possibile assegnare un nome alla tabella inline, proprio come per qualsiasi tabella caricata. L'assegnazione di un nome alla tabella è facoltativo.
Dopo il nome della tabella, inserire due punti.
Istruzioni LOAD e inline
Una tabella inline viene caricata con la clausola inline quando si utilizza l'istruzione di script LOAD. La clausola inline indica che il testo successivo nella tabella conterrà dati inseriti manualmente nell'editor. A meno che non si indichi diversamente, una tabella inline utilizza il formato txt, che segue la struttura di un file di testo delimitato.
Per ulteriori informazioni sull'istruzione LOAD, vedere Load.
Delimitatori e inserimento dati
I dati immessi mediante una clausola inline devono essere racchiusi da caratteri specifici. Di seguito ecco un elenco delle combinazioni di caratteri accettate per racchiudere i dati:
Parentesi quadre: [ e ]
Virgolette doppie: " e "
Virgolette singole: ' e '
Apici inversi: ` e `
I caratteri scelti come delimitatori consentono di caricare dati inline che contengono caratteri in conflitto. Per esempio, se i dati contengono record con parentesi quadre, è possibile includerli utilizzando invece le virgolette o gli apici inversi.
Se non si specifica un formato alternativo per una tabella (quello predefinito è txt), il testo tra i caratteri delimitatori viene interpretato come il contenuto di un file. Pertanto, quando si desidera immettere una nuova riga in un file di testo, è necessario eseguire la stessa operazione anche nel testo di una clausola inline: premendo il tasto INVIO mentre si digita lo script.
Fine di un caricamento inline
La fine dell'istruzione di caricamento inline è indicata con un punto e virgola.
Trasformazioni dati
In un semplice caricamento inline senza trasformazioni, il numero di colonne è definito nella prima riga. La tabella caricata nell'esempio seguente ha tre colonne: Product_ID, Supplier_Name e Product_Category.
È possibile anche eseguire trasformazioni e creare nuove colonne all'interno della stessa tabella inline. È possibile utilizzare carichi precedenti e più di un'istruzione LOAD per caricare la stessa tabella.
Configurazione della specifica del formato in un caricamento inline
Come per le altre tabelle caricate, è possibile modificare la specifica del formato delle tabelle inline utilizzando gli elementi di specifica del formato. La specifica del formato viene aggiunta tra parentesi. Quest'ultima deve essere aggiunta dopo i caratteri delimitatori dei dati, ma prima del punto e virgola che delimita la fine dell'istruzione LOAD. Alcune delle personalizzazioni che è possibile aggiungere includono i seguenti elementi:
Inoltre, poiché un caricamento inline è un'istruzione LOAD, è possibile combinare altri argomenti per l'istruzione LOAD nel caricamento inline. Per esempio, utilizzare le clausole where o while per definire se caricare in una riga specifica o meno, in base al testo incluso.
In modo simile, è possibile utilizzare gli operatori al di fuori del contenuto stesso del testo. Con gli operatori, è possibile personalizzare il modo in cui trasformare i dati inline, oltre a definire quando caricare determinati dati o meno.
Esempio: caratteri delimitatori alternativi dei dati
Per racchiudere un caricamento inline, è possibile utilizzare parentesi quadre, virgolette o apici inversi. In questa sezione il processo viene descritto con un esempio. Per ulteriori informazioni, vedere Delimitatori e inserimento dati.
In questo esempio si dimostra come è possibile utilizzare gli apici inversi per racchiudere i dati inline. I dati nell'esempio contengono i caratteri parentesi quadre, che le rendono incompatibili come caratteri delimitatori per l'istruzione LOAD.
Panoramica
Aprire Editor caricamento dati, quindi aggiungere il seguente script di caricamento in una nuova scheda.
L'utilizzo di un delimitatore differente è utile quando i dati nella tabella contengono virgole, che altrimenti segnalano il passaggio alla colonna successiva nella tabella.
Aprire l'editor caricamento dati e aggiungere lo script di caricamento sotto in una nuova scheda.
Lo script di caricamento contiene:
Vi sono quattro tabelle da caricare. Le tabelle sono le seguenti:
Table1: il delimitatore è una barra verticale. I dati nella colonna Phrase contengono virgole.
Table2: il delimitatore è un carattere di due punti.
Table3: il delimitatore è una barra inversa.
Table4: la tabella è delimitata premendo il tasto Tab sulla tastiera. Questa opzione è utile se si desidera copiare una tabella da un programma di elaborazione testi e incollarlo in uno script.
Table1 mostra un caso di utilizzo pratico per l'utilizzo di un delimitatore alternativo. Le altre tavelle mostrano maggiori opzioni per la delimitazione.
Script di caricamento
Table1:
LOAD * INLINE [
ID|Phrase
1 | 'The transaction was complete, but the order has not yet shipped.'
2 | 'We need to confirm the following details: sales rep number, order status, and shipping priority.'
] (Delimiter is '|');
Table2:
LOAD * INLINE [
Num1:Chr1
1:A
2:B ] (Delimiter is ':');
Table3:
LOAD * INLINE [
Num2\Chr2
1\A
2\B ] (Delimiter is \\);
Table4:
LOAD * INLINE [
Num3 Chr3
1 A
2 B ] (Delimiter is '\t');
Risultati
Caricare i dati e aprire un foglio. Creare quattro tabelle e inserire le dimensioni come segue:
Table1: ID, Phrase
Table2: Num1, Chr1
Table3: Num2, Chr2
Table4: Num3, Chr3
Tabella dei risultati: Table1
ID
Phrase
1
The transaction was complete, but the order has not yet shipped.
2
We need to confirm the following details: sales rep number, order status, and shipping priority.
Tabella dei risultati: Table2
Num1
Chr1
1
A
2
B
Tabella dei risultati: Table3
Num2
Chr2
1
A
2
B
Tabella dei risultati: Table4
Num3
Chr3
1
A
2
B
Esempio: utilizzo di caricamenti inline e caricamenti da altre sorgenti dati
Panoramica
Il seguente script prima carica una serie di campi da un connettore, quindi carica una tabella inline con un campo comune e un campo aggiuntivo. Questo nuovo campo fornisce un'altra proprietà relativa all'elemento della riga che non è stata caricata tramite la connessione dati. Notare che questa opzione funziona senza errori solo se è presente un unico nome di campo in comune tra le due tabelle. Se sono presenti più nomi di campo in comune, viene generata una chiave sintetica.
In questo esempio con troncamento, si carica una tabella con i dettagli dell'ordine da una connessione dati. Quindi, viene utilizzata una tabella inline per aggiungere un campo aggiuntivo, Supplemental Info. Questo può, per esempio, contenere i dettagli sui commenti speciali sugli ID specifici dell'ordine.
Script di caricamento
SET DateFormat='MM/DD/YYYY';
Orders:
LIB CONNECT TO 'My_Generic_Connection';
LOAD PRODUCT_DIVISION_A_ORDER_ID as Order ID,
PRODUCT_DIVISION_A_ORDER_DATE as ISSUE_KEY as Order Date,
PRODUCT_DIVISION_A_TYPE as Product Type,
PRODUCT_DIVISION_A_SALES_MANAGER as Manager,
PRODUCT_DIVISION_A_SHIPPED_STATUS as Shipped Status;
SELECT PRODUCT_DIVISION_A_ORDER_ID,
PRODUCT_DIVISION_A_ORDER_DATE,
PRODUCT_DIVISION_A_TYPE,
PRODUCT_DIVISION_A_SALES_MANAGER,
PRODUCT_DIVISION_A_SHIPPED_STATUS
FROM SourceTable
WITH PROPERTIES (
[...]
);
Orders_Inline_Info:
load * inline [
Order ID,Supplemental Info
PSF-001014,'Bulk order, pending deal with Paracel.'
PSF-001625,'NOTE: Product damaged. Investigation required.'
];
Risultati
Una volta caricati i dati, si possono aggiungere le seguenti dimensioni a una tabella:
Order ID
Order Date
Product Type
Manager
Shipped Status
Supplemental Info
Il grafico risultante essere simile al seguente.
Tabella dei risultati: Orders
Order ID
Order Date
Product Type
Manager
Shipped Status
Supplemental Info
PSF-000998
1/13/2024
Electronics
Amanda Honda
Shipped
-
PSF-000999
1/15/2024
Automotive
Molly McKenzie
Not Shipped
-
PSF-001014
1/17/2024
Home Appliances
Amalia Craig
Undefined
Bulk order, pending deal with Paracel.
PSF-001625
1/21/2024
Electronics
Amanda Honda
Undefined
Product damaged. Investigation required.
Notare come è possibile aggiungere tutti i campi alla stessa visualizzazione da entrambe le tabelle. Le tabelle sono associate l'una all'altra nel modello dati.
Esempio: omissione delle intestazioni di colonna
Modificare la specifica del formato per caricare una tabella inline senza definire le intestazioni di colonna. È possibile completare questa operazione con la specifica labels (impostandola sul valore no labels). Per ulteriori informazioni, vedere Configurazione della specifica del formato in un caricamento inline.
Quando si carica una tabella senza definire i nomi di colonna, i nomi di colonna definiti dal sistema vengono utilizzati automaticamente.
Panoramica
In questo esempio si mostra come è possibile caricare una tabella inline senza definire i nomi di colonna.
Aprire Editor caricamento dati, quindi aggiungere il seguente script di caricamento in una nuova scheda.
Aprire l'editor caricamento dati e aggiungere lo script di caricamento sotto in una nuova scheda.
Lo script di caricamento contiene:
Un semplice caricamento inline per definire la tabella T1.
Utilizzare l'identificatore Quotes (con il valore msq) per supportare contenuti multiriga.
I valori di lunghezza sono specificati in piedi e pollici.
Il simbolo delle virgolette doppie (") indica la fine di una voce multiriga. Nel seguente esempio, lo stesso simbolo viene utilizzato anche per indicare i valori in pollici. In questo modo, è possibile visualizzare la sintassi e il comportamento risultante se è necessario e utilizzare la stessa istruzione LOAD. In sostanza, l'immissione del simbolo " per due caratteri consecutivi ("") indica che il codice deve essere interpretato come un'unica istanza di testo del simbolo.
Script di caricamento
T1:
Load *, recno() as ID inline [
Length
"1' 2""
22' 10"""
14' 8" ] (msq);
Risultati
Caricare i dati e aprire un foglio. Creare una nuova tabella e aggiungere tali campi come dimensioni:
ID
Length
Per visualizzare contenuti multiriga come previsto, è necessario attivare l'impostazione Testo a capo nelle celle nel pannello delle proprietà. Inoltre, il tema dell'app (o l'impostazione visualizzazione) deve consentire un'Altezza riga (in linee) sufficiente.
Tabella dei risultati
ID
Length
1
1' 2"
22' 10"
2
14' 8"
Nella tabella riportata sopra, il record con un valore ID di 1 contiene contenuti multiriga.
Esempi: caricamenti inline e trasformazioni
Nei seguenti esempi si mostra come è possibile eseguire i calcoli nei campi caricati inline per creare nuovi campi nel modello dati.
Aprire Editor caricamento dati, quindi aggiungere il seguente script di caricamento in una nuova scheda.
Script di caricamento
ORDERS:
Load Original as Updated,
* Inline
[
Original
ProductA
ProductB
ProductC
];
Risultati
Caricare i dati e aprire un foglio. Creare una nuova tabella e aggiungere tali campi come dimensioni:
Original
Updated
Tabella dei risultati
Original
Updated
ProductA
ProductA
ProductB
ProductB
ProductC
ProductC
Panoramica
In questo esempio si mostra come è possibile definire un campo calcolato per indicare l'ID di ogni riga di dati, senza digitare manualmente il valore di ogni ID.
Aprire Editor caricamento dati, quindi aggiungere il seguente script di caricamento in una nuova scheda.
Script di caricamento
ORDERS:
Load RowNo() as ID,
* Inline
[
ProductName
A
B
C
D
E
];
Risultati
Caricare i dati e aprire un foglio. Creare una nuova tabella e aggiungere tali campi come dimensioni:
ID
ProductName
Tabella dei risultati
ID
ProductName
1
A
2
B
3
C
4
D
5
E
Panoramica
In questo esempio si mostrano diversi modi in cui è possibile applicare una trasformazione semplice ai dati inline. È possibile utilizzare una o più istruzioni LOAD e configurare la sintassi in modi diversi, per definire se una trasformazione sostituisce o meno il campo originale o se caricare sia i campi nuovi che quelli originali.
In particolare, notare le variazioni nel seguente esempio e come incidono sull'output:
Numero di istruzioni LOAD nella tabella.
Presenza o assenza del simbolo * (carica tutti i campi successivi).
Presenza o assenza di virgole (simbolo ,).
Aprire l'editor caricamento dati e aggiungere lo script di caricamento sotto in una nuova scheda.
Lo script di caricamento contiene:
Quattro tabelle che fanno riferimento agli stessi dati. I nuovi di campo sono differenti.
DerivedYears1: utilizza due istruzioni LOAD per caricare una colonna inline e una colonna contenente una trasformazione di una colonna inline.
DerivedYears2: utilizza due istruzioni LOAD. Lo script carica una colonna inline, quindi carica un campo calcolato trasformato dalla colonna originale. Con la seconda istruzione LOAD, la colonna originale non viene caricata nella tabella, in modo da rendere in modo efficiente il nuovo campo una sostituzione di quello originale.
DerivedYears3: utilizza una singola istruzione LOAD per caricare sia la colonna inline originale che quella trasformata.
DerivedYears4: utilizza una singola istruzione LOAD per definire un campo inline e una trasformazione del campo originale. Nella tabella viene caricato solo il campo trasformato.
Caricare i dati e aprire un foglio. Creare tre tabelle e aggiungere le dimensioni come segue:
DerivedYears1: initial_date1, derived_year1
DerivedYears2: initial_date2
DerivedYears3: initial_date3, derived_year3
Tabella dei risultati: DerivedYears1
initial_date1
derived_year1
1/1/2022
2022
1/1/2023
2023
1/1/2024
2024
Tabella dei risultati: DerivedYears2
derived_year2
2022
2023
2024
Tabella dei risultati: DerivedYears3
initial_date3
derived_year3
1/1/2022
2022
1/1/2023
2023
1/1/2024
2024
Tabella dei risultati: DerivedYears4
derived_year4
2022
2023
2024
Panoramica
Supponiamo che sia necessario incollare le informazioni da un file di testo di grandi dimensioni nell'Editor script, ma che si desideri eseguire elaborazioni aggiuntive sui record nel set di dati. Per esempio, si desidera rimuovere determinati caratteri e prefissi scrivere ogni parola in maiuscolo.
Aprire l'editor caricamento dati e aggiungere lo script di caricamento sotto in una nuova scheda.
Lo script di caricamento contiene:
Una tabella inline, Transformations, nella quale viene definita una trasformazione per modificare il contenuto di testo di un campo. Il testo da trasformare viene aggiunto subito dopo.
Due istruzioni LOAD. Con la configurazione dell'esempio, viene caricato nella tabella solo il campo derivato ProductName_Trimmed.
Script di caricamento
Transformations:
Load
Capitalize(TextBetween(OrigColumn, '{','}')) as ProductName_Trimmed;
Load * inline [
OrigColumn
Product: {soft drinks and other beverages}
Product: {snack food}
Product: {electronics and video games}
];
Risultati
Caricare i dati e aprire un foglio. Creare una nuova tabella e aggiungere questo campo come dimensione: ProductName_Trimmed.
Tabella dei risultati
ProductName_Trimmed
Soft Drinks And Other Beverages
Snack Food
Electronics And Video Games
Esempio: operatori per trasformazioni e clausole
È possibile utilizzare degli operatori per definire trasformazioni e clausole specifiche nell'istruzione LOAD. Per ulteriori informazioni, vedere Operatori altre clausole.
Aprire l'editor caricamento dati e aggiungere lo script di caricamento sotto in una nuova scheda.
Lo script di caricamento contiene:
Un semplice caricamento inline per definire la tabella Purchases.
L'inserimento di un campo calcolato, OrderSize. Questo campo è una trasformazione del campo amount da un set di dati inline. Questo categorizza gli acquisti come piccoli o grandi, dipendendo se l'importo supera o meno $2000,00.
Una clausola where che impedisce ai record di essere caricati quando amount è inferiore a $0,05.
Caricare i dati e aprire un foglio. Creare una nuova tabella e aggiungere tali campi come dimensioni:
ID
amount
OrderSize
Tabella dei risultati
ID
amount
OrderSize
1
2660.39
Large Purchase
2
100.01
Small Purchase
3
500.42
Small Purchase
4
5023.99
Large Purchase
6
2002.39
Large Purchase
7
31034.53
Large Purchase
8
1643.58
Small Purchase
9
3993.65
Large Purchase
10
614.34
Small Purchase
11
675.93
Small Purchase
Nella tabella riportata sopra, la transazione con unID di 5 non è stato caricato nella tabella. Ciò è dovuto al fatto che il valore di amount è inferiore a $0,05.
Esempio: creazione di valori null in una tabella inline
In questo esempio si mostra come è possibile utilizzare la variabile NullInterpret per creare valori null nei dati inline.
Aprire l'editor caricamento dati e aggiungere lo script di caricamento sotto in una nuova scheda.
Lo script di caricamento contiene:
Un semplice caricamento inline per definire la tabella T2.
La variabile NullInterpret definita come virgolette singole. Quando lo script viene caricato, i record contenenti questo valore vengono elaborati come valori null.
Script di caricamento
set nullinterpret = '';
T2:
Load * inline [
Test
''
x ];
Risultati
Caricare i dati e aprire un foglio. Creare una nuova tabella e aggiungere questo campo come dimensione: Test.
Tabella dei risultati
Test
x
Nella tabella riportata sopra, il primo record è un valore null. Pertanto, non è incluso nella visualizzazione. I valori null esistenti nelle tabelle con dimensioni aggiuntive sono indicati dal simbolo -.
Se riscontri problemi con questa pagina o con il suo contenuto – un errore di battitura, un passaggio mancante o un errore tecnico – facci sapere come possiamo migliorare!