# Load L'istruzione LOAD carica i campi da un file, dai dati definiti nello script, da una tabella caricata in precedenza, da una pagina Web, dal risultato di un'istruzione SELECT seguente o dalla generazione automatica di dati. Sintassi: LOAD [ distinct ] fieldlist [( from file [ format-spec ] | from\_field fieldassource [format-spec] inline data [ format-spec ] | *resident* table-label | autogenerate size )] [ where criterion | while criterion ] [ group\_by groupbyfieldlist ] [order\_by orderbyfieldlist ] Argomenti: Caricare gli argomenti | Argomento | Descrizione | | --- | --- | | distinct [](https://help.qlik.com/en-US/qlikview/Subsystems/Client/Content/QV_QlikView/Scripting/ScriptRegularStatements/Load.htm)[](https://help.qlik.com/en-US/qlikview/Subsystems/Client/Content/QV_QlikView/Scripting/ScriptRegularStatements/Load.htm) | È possibile utilizzare distinct come predicato se si vogliono caricare solo record unici. In presenza di record duplicati, verrà caricata la prima istanza.

Se si utilizzano carichi precedenti, è necessario posizionare distinct nella prima istruzione LOAD, dato che distinct influisce solo sulla tabella di destinazione. | | fieldlist | fieldlist ::= ( \* \| field {, field } )

Un elenco di campi da caricare. L'utilizzo del carattere \* come elenco dei campi indica tutti i campi della tabella.

field ::= ( fieldref \| expression ) [as aliasname ]

La definizione di campo deve sempre contenere un valore letterale, un riferimento a un campo esistente o un'espressione.

fieldref ::= ( fieldname \|@fieldnumber \|@startpos:endpos [ I \| U \| R \| B \| T] )

fieldname è un testo che è identico al nome di un campo nella tabella. Tenere presente che il nome di campo deve essere racchiuso da virgolette doppie o parentesi quadre se, ad esempio, contiene spazi. Talvolta i nomi dei campi non sono disponibili in modo esplicito. Verrà quindi utilizzata una notazione differente:

@fieldnumber rappresenta il numero di campo di un file tabellare delimitato. Deve essere un intero positivo preceduto da "@". La numerazione viene sempre eseguita partendo da 1 fino al numero di campi presenti.

@startpos:endpos rappresenta le posizioni di inizio e di fine di un campo in un file con record a lunghezza fissa. Le posizioni devono essere entrambe numeri interi positivi. I due valori numerici devono essere preceduti dal simbolo "@" e separati da due punti. La numerazione viene sempre eseguita partendo da 1 fino al numero di posizioni presenti. Nell'ultimo campo n viene utilizzato come posizione finale.



expression può essere una funzione numerica o una funzione stringa basata su uno o molti altri campi della stessa tabella. Per ulteriori informazioni, vedere la sintassi delle espressioni.

[](https://help.qlik.com/en-US/qlikview/Subsystems/Client/Content/QV_QlikView/Scripting/ScriptRegularStatements/Load.htm)[](https://help.qlik.com/en-US/qlikview/Subsystems/Client/Content/QV_QlikView/Scripting/ScriptRegularStatements/Load.htm)as viene utilizzato per assegnare un nuovo nome al campo. | | [](https://help.qlik.com/en-US/qlikview/Subsystems/Client/Content/QV_QlikView/Scripting/ScriptRegularStatements/Load.htm)[](https://help.qlik.com/en-US/qlikview/Subsystems/Client/Content/QV_QlikView/Scripting/ScriptRegularStatements/Load.htm)[](https://help.qlik.com/en-US/qlikview/Subsystems/Client/Content/QV_QlikView/Scripting/ScriptRegularStatements/Load.htm)from | from viene utilizzato se i dati devono essere caricati da un file.

file ::= [ path ] filename



Se il percorso viene omesso, QlikView ricerca il file nella directory specificata dall'istruzione Directory. Se non è presente l'istruzione Directory, QlikView effettua la ricerca nella directory di lavoro, corrispondente in genere alla directory in cui si trova il file QlikView.

Nota informaticaIn un'installazione server di QlikView la directory di lavoro predefinita è C:\ProgramData\QlikTech\Documents. La directory di lavoro predefinita può essere modificata in Console di gestione QlikView.

filename può contenere i caratteri jolly DOS standard (\* e ?). Tutti i file corrispondenti verranno caricati nella directory specificata.

format-spec ::= ( fspec-item { , fspec-item } )

La specifica del formato è costituita da un elenco di più voci di specifica del formato, racchiuse tra parentesi.

[Directory](https://help.qlik.com/it-IT/qlikview/May2024/Subsystems/Client/Content/QV_QlikView/Scripting/ScriptRegularStatements/Directory.htm)

[From](https://help.qlik.com/it-IT/qlikview/May2024/Subsystems/Client/Content/QV_QlikView/Scripting/ScriptRegularStatements/From.htm) | | [](https://help.qlik.com/en-US/qlikview/Subsystems/Client/Content/QV_QlikView/Scripting/ScriptRegularStatements/Load.htm)from\_field | from\_field viene utilizzato nel caso in cui i dati devono essere caricati da un campo caricato in precedenza.

fieldassource::=(tablename, fieldname)

Il campo è il nome del valore di tablename e fieldname caricato in precedenza.

format-spec ::= ( fspec-item {, fspec-item } )

La specifica del formato è costituita da un elenco di più voci di specifica del formato, racchiuse tra parentesi. | | [](https://help.qlik.com/en-US/qlikview/Subsystems/Client/Content/QV_QlikView/Scripting/ScriptRegularStatements/Load.htm)[](https://help.qlik.com/en-US/qlikview/Subsystems/Client/Content/QV_QlikView/Scripting/ScriptRegularStatements/Load.htm)inline | inline viene utilizzato quando i dati devono essere immessi direttamente nello script e non caricati da un file.

data ::= [ text ]

I dati immessi mediante una clausola inline devono essere racchiusi da caratteri specifici, come parentesi quadre, virgolette doppie o apici. Il testo tra parentesi o virgolette viene interpretato allo stesso modo del 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.

In un semplice caricamento inline, il numero di colonne è definito nella prima riga.

format-spec ::= ( fspec-item {, fspec-item } )

È possibile personalizzare il caricamento inline con molti degli stessi elementi di specifica del formato disponibili per le altre tabelle caricate. Queste voci sono elencate tra parentesi. Per ulteriori informazioni, vedere [Voci per la specifica del formato](https://help.qlik.com/it-IT/qlikview/May2024/Subsystems/Client/Content/QV_QlikView/Scripting/ScriptSpecifiers/format-specification-items.htm).

Per ulteriori informazioni sui caricamenti inline, vedere [Caricamento dei dati da tabelle inline](https://help.qlik.com/it-IT/qlikview/May2024/Subsystems/Client/Content/QV_QlikView/Scripting/inline-loads-qv.htm). | | [](https://help.qlik.com/en-US/qlikview/Subsystems/Client/Content/QV_QlikView/Scripting/ScriptRegularStatements/Load.htm)[](https://help.qlik.com/en-US/qlikview/Subsystems/Client/Content/QV_QlikView/Scripting/ScriptRegularStatements/Load.htm)resident | resident viene usato se i dati devono essere caricati da una tabella caricata in precedenza.

table label è un'etichetta che precede le istruzioni LOAD o SELECT che hanno creato la tabella originale. L'etichetta dovrà essere indicata con i due punti finali.

Quando si utilizza una combinazione di istruzioni LOAD distinct e resident in QlikView 12.00 o versioni successive, l'ordine di caricamento dei dati è diverso rispetto a QlikView 11.20. Per definire un ordine di caricamento desiderato, aggiungere una clausola order by.

[Caricamento di dati da una tabella caricata in precedenza](https://help.qlik.com/it-IT/qlikview/May2024/Subsystems/Client/Content/QV_QlikView/Scripting/load-data-from-previously-loaded-table.htm)

[Etichette di tabella](https://help.qlik.com/it-IT/qlikview/May2024/Subsystems/Client/Content/QV_QlikView/Scripting/table-labels.htm) | | [](https://help.qlik.com/en-US/qlikview/Subsystems/Client/Content/QV_QlikView/Scripting/ScriptRegularStatements/Load.htm)[](https://help.qlik.com/en-US/qlikview/Subsystems/Client/Content/QV_QlikView/Scripting/ScriptRegularStatements/Load.htm)autogenerate | autogenerate viene utilizzato se i dati devono essere automaticamente generati da QlikView.

size ::= number

Number è un numero intero e indica il numero di record che da generare. L'elenco dei campi non deve contenere espressioni che richiedono dati acquisiti da un database. Nelle espressioni sono consentite solo costanti e funzioni senza parametri, ad esempio rand() o recno(). | | extension | È possibile caricare dati da connessioni di analisi. È necessario utilizzare la clausola extension per chiamare una funzione definita nel plug-in SSE (Server-Side Extension) o per valutare uno script.

È possibile inviare una singola tabella al plug-in SSE, che restituisce una singola tabella di dati. Se il plug-in non specifica i nomi dei campi restituiti, i campi saranno denominati Field1, Field2 e così via.

Extension pluginname.functionname( tabledescription );



Gestione dei tipi di dati nella definizione dei campi della tabella

I tipi di dati sono riconosciuti automaticamente nelle connessioni di analisi. Se i dati non hanno valori numerici e hanno almeno una stringa di testo non NULL, il campo è considerato di tipo testo. In tutti gli altri casi è considerato di tipo numerico.

È possibile forzare il tipo di dati racchiudendo il nome del campo in String() o Mixed().



String() o Mixed() non possono essere utilizzati esternamente alle definizioni dei campi della tabella extension e non è possibile utilizzare altre funzioni di QlikView nella definizione di un campo della tabella.

Ulteriori informazioni sulle connessioni di analisi

Per la creazione di una connessione analitica in QlikView Server o QlikView Desktop, vedere: [Connessioni analitiche](https://help.qlik.com/it-IT/qlikview/May2024/Subsystems/Client/Content/QV_QlikView/Analytic_connections.htm)

Ulteriori informazioni sulle connessioni di analisi sono disponibili nel repository di GitHub. [qlik-oss/server-side-extension](https://github.com/qlik-oss/server-side-extension) | | [](https://help.qlik.com/en-US/qlikview/Subsystems/Client/Content/QV_QlikView/Scripting/ScriptRegularStatements/Load.htm)[](https://help.qlik.com/en-US/qlikview/Subsystems/Client/Content/QV_QlikView/Scripting/ScriptRegularStatements/Load.htm)where | where è una clausola utilizzata per dichiarare se un record deve essere incluso o meno nella selezione. La selezione viene inclusa se criterion è True.

criterion è un'espressione logica. | | [](https://help.qlik.com/en-US/qlikview/Subsystems/Client/Content/QV_QlikView/Scripting/ScriptRegularStatements/Load.htm)[](https://help.qlik.com/en-US/qlikview/Subsystems/Client/Content/QV_QlikView/Scripting/ScriptRegularStatements/Load.htm)while | while è una clausola che specifica se un record deve essere letto ripetutamente. Viene letto lo stesso record finché criterion è True. Per risultare utile, una clausola while deve generalmente includere la funzione IterNo( ).

criterion è un'espressione logica. | | [](https://help.qlik.com/en-US/qlikview/Subsystems/Client/Content/QV_QlikView/Scripting/ScriptRegularStatements/Load.htm)[](https://help.qlik.com/en-US/qlikview/Subsystems/Client/Content/QV_QlikView/Scripting/ScriptRegularStatements/Load.htm)group\_by | group by è una clausola usata per definire su quali campi devono essere aggregati (raggruppati) i dati. I campi di aggregazione devono essere inclusi in qualche modo nelle espressioni caricate. Nessun altro campo tranne i campi di aggregazione può essere usato al di fuori delle funzioni di aggregazione nelle espressioni caricate.

groupbyfieldlist ::= (fieldname { ,fieldname } ) | | [](https://help.qlik.com/en-US/qlikview/Subsystems/Client/Content/QV_QlikView/Scripting/ScriptRegularStatements/Load.htm)[](https://help.qlik.com/en-US/qlikview/Subsystems/Client/Content/QV_QlikView/Scripting/ScriptRegularStatements/Load.htm)order\_by | order by è una clausola utilizzata per ordinare i record di una tabella residente prima che vengano elaborati da un’istruzione load. La tabella residente può essere ordinata su uno o più campi, in modo crescente o decrescente. L'ordinamento viene eseguito innanzitutto in base ai valori numerici e secondariamente in base all'ordine di confronto nazionale. Questa clausola può essere utilizzata solamente quando la sorgente dati è una tabella residente.

I campi di ordinamento specificano il campo in base al quale viene ordinata la tabella residente. Il campo può essere specificato da un nome o dal suo numero nella tabella residente (il primo campo è il numero 1).

orderbyfieldlist ::= fieldname [ sortorder ] { , fieldname [ sortorder ] }

sortorder è asc per crescente o desc per decrescente. Se sortorder non è specificato, viene utilizzato asc.

fieldname, path, filename e aliasname sono stringhe di testo che rappresentano ciò che implica il loro rispettivo nome. Qualsiasi campo presente nella tabella sorgente può essere utilizzato come fieldname. Tuttavia, i campi creati mediante la clausola as (aliasname) non appartengono all'ambito e non possono essere utilizzati all'interno della stessa istruzione load. | Se non viene specificata alcuna sorgente dati mediante una clausola from, inline, resident, from\_field o autogenerate, i dati verranno caricati dal risultato dell'istruzione SELECT o LOAD immediatamente successiva. L'istruzione successiva non dovrà avere un prefisso. [Preceding LOAD](https://help.qlik.com/it-IT/qlikview/May2024/Subsystems/Client/Content/QV_QlikView/Scripting/preceding-load.htm) Esempi: [](https://help.qlik.com/en-US/qlikview/Subsystems/Client/Content/QV_QlikView/Scripting/ScriptRegularStatements/Load.htm) #### Caricamento di formati di file differenti Caricare un file di dati delimitato con le opzioni predefinite: `LOAD * from data1.csv; ` ` ` Caricare un file delimitato specificando la virgola come delimitatore e con etichette incorporate: `LOAD * from 'c:\userfiles\data1.csv' (ansi, txt, delimiter is ',', embedded labels); ` ` ` Caricare un file delimitato specificando la tabulazione come delimitatore e con etichette incorporate: `LOAD * from 'c:\userfiles\data2.txt' (ansi, txt, delimiter is '\t', embedded labels);` ` ` Caricare un file dif con intestazioni incorporate: `LOAD * from file2.dif (ansi, dif, embedded labels);` ` ` Caricare tre campi da un file Record Fixed senza intestazioni: `LOAD @1:2 as ID, @3:25 as Name, @57:80 as City from data4.fix (ansi, fix, no labels, header is 0, record is 80); ` ` ` Caricare un file QVX specificando un percorso assoluto: `LOAD * from C:\qdssamples\xyz.qvx (qvx);` ` ` [](https://help.qlik.com/en-US/qlikview/Subsystems/Client/Content/QV_QlikView/Scripting/ScriptRegularStatements/Load.htm) #### Selezione di alcuni campi, ridenominazione e calcolo dei campi Caricare solo tre campi specifici da un file delimitato: `LOAD FirstName, LastName, Number from data1.csv; ` ` ` Assegnare il nome A al primo campo e il nome B al secondo campo durante il caricamento di un file senza etichette: `LOAD @1 as A, @2 as B from data3.txt (ansi, txt, delimiter is '\t', no labels); ` ` ` Caricare Name come concatenazione di FirstName, uno spazio e LastName: `LOAD FirstName&' '&LastName as Name from data1.csv; ` ` ` Caricare Quantity, Price e Value (il prodotto di Quantity e Price): `LOAD Quantity, Price, Quantity*Price as Value from data1.csv;` [](https://help.qlik.com/en-US/qlikview/Subsystems/Client/Content/QV_QlikView/Scripting/ScriptRegularStatements/Load.htm) #### Selezione di alcuni record Caricare solo i record univoci mentre i record duplicati verranno eliminati: `LOAD distinct FirstName, LastName, Number from data1.csv; ` ` ` Caricare solo i record in cui il campo Litres presenta un valore superiore a zero: `LOAD * from Consumption.csv where Litres>0; ` [](https://help.qlik.com/en-US/qlikview/Subsystems/Client/Content/QV_QlikView/Scripting/ScriptRegularStatements/Load.htm) #### Caricamento di dati non presenti nel file e di dati generati automaticamente Caricare una tabella con dati inline, due campi denominati CatID e Category: ` LOAD * Inline ` ` [CatID, Category ` ` 0,Regular ` ` 1,Occasional ` ` 2,Permanent]; ` ` ` Caricare una tabella con dati inline, tre campi denominati UserID, Password e Access: ` LOAD * Inline [UserID, Password, Access ` ` A, ABC456, User ` ` B, VIP789, Admin]; ` ` ` Caricare una tabella con 10.000 righe. Il campo A conterrà il numero del record letto (1,2,3,4,5...), mentre il campo B conterrà un numero casuale compreso tra 0 e 1: `LOAD RecNo( ) as A, rand( ) as B autogenerate(10000);` Nota informaticaLa parentesi dopo autogenerate è consentita, ma non obbligatoria. [](https://help.qlik.com/en-US/qlikview/Subsystems/Client/Content/QV_QlikView/Scripting/ScriptRegularStatements/Load.htm) #### Caricamento di dati da una tabella caricata in precedenza Caricare dapprima un file tabella delimitato assegnandogli il nome tab1: ` tab1: ` `SELECT A,B,C,D from transtable; ` ` ` Caricare i campi dalla tabella tab1 già caricata come tab2: `tab2:` `LOAD A,B,month(C),A*B+D as E resident tab1;` ` ` Caricare i campi dalla tabella già caricata tab1, ma solo i record in cui A è maggiore di B: `tab3:` `LOAD A,A+B+C resident tab1 where A>B;` ` ` Caricare i campi dalla tabella già caricata tab1 ordinati in base a A: `LOAD A,B*C as E resident tab1 order by A;` ` ` Caricare campi dalla tabella tab1 già caricata, ordinata in base al primo campo, quindi in base al secondo campo: `LOAD A,B*C as E resident tab1 order by 1,2;` ` ` Caricare i campi dalla tabella tab1 già caricata, ordinata in ordine decrescente in base a C, quindi in ordine crescente in base a B e quindi in base al primo campo in ordine decrescente: `LOAD A,B*C as E resident tab1 order by C desc, B asc, 1 des;` [](https://help.qlik.com/en-US/qlikview/Subsystems/Client/Content/QV_QlikView/Scripting/ScriptRegularStatements/Load.htm) #### Caricamento di dati da campi caricati in precedenza Caricare il campo Types dalla tabella caricata in precedenza Characters come A: `LOAD A from_field (Characters, Types);` [](https://help.qlik.com/en-US/qlikview/Subsystems/Client/Content/QV_QlikView/Scripting/ScriptRegularStatements/Load.htm) #### Caricamento di dati da una tabella successiva (preceding LOAD) Caricare A, B e i campi calcolati X e Y dalla tabella Table1, caricata nell'istruzione SELECT successiva: ` LOAD A, B, if(C>0,'positive','negative') as X, weekday(D) as Y; ` `SELECT A,B,C,D from Table1;` ` ` [Preceding LOAD](https://help.qlik.com/it-IT/qlikview/May2024/Subsystems/Client/Content/QV_QlikView/Scripting/preceding-load.htm) [](https://help.qlik.com/en-US/qlikview/Subsystems/Client/Content/QV_QlikView/Scripting/ScriptRegularStatements/Load.htm) #### Raggruppamento di dati Caricare campi raggruppati (aggregati) in base a ArtNo: `LOAD ArtNo, round(Sum(TransAmount),0.05) as ArtNoTotal from table.csv group by ArtNo; ` ` ` Caricare campi raggruppati (aggregati) in base a Week e ArtNo: `LOAD Week, ArtNo, round(Avg(TransAmount),0.05) as WeekArtNoAverages from table.csv group by Week, ArtNo;` ` ` [](https://help.qlik.com/en-US/qlikview/Subsystems/Client/Content/QV_QlikView/Scripting/ScriptRegularStatements/Load.htm) #### Lettura ripetuta di un record In questo esempio è presente un file di input Grades.csv contenente i voti per ogni studente raccolti in un singolo campo: `Student,Grades` `Mike,5234` `John,3345` `Pete,1234` `Paul,3352` I voti, in una scala da 1 a 5, rappresentano le materie Math, English, Science e History. È possibile suddividere i voti in valori separati leggendo ogni record più volte con una clausola while, utilizzando la funzione IterNo( ) come contatore. In ogni lettura il voto viene estratto con la funzione Mid e memorizzato in Grade, mentre la materia viene selezionata utilizzando la funzione pick e memorizzata in Subject. La clausola while finale contiene il test per verificare che siano stati letti tutti i voti (in questo caso quattro per studente), il che significa che deve essere letto il record dello studente successivo. ` MyTab: ` ` LOAD Student, ` ` mid(Grades,IterNo( ),1) as Grade, ` ` pick(IterNo( ), 'Math', 'English', 'Science', 'History') as Subject from Grades.csv ` `while IsNum(mid(Grades,IterNo(),1));` ` ` Il risultato è una tabella contenente i seguenti dati: ![A table containing data for Students, Subjects, and Grades.](https://help.qlik.com/it-IT/qlikview/May2024/Subsystems/Client/Content/Resources/Images/ex_gen_LoadRepeated.png) [](https://help.qlik.com/en-US/qlikview/Subsystems/Client/Content/QV_QlikView/Scripting/ScriptRegularStatements/Load.htm) #### Caricamento da connessioni di analisi Sono utilizzati i dati campione seguenti. ``` Values: Load Rand() as A, Rand() as B, Rand() as C AutoGenerate(50); ``` Caricamento di dati mediante una funzione In questi esempi si suppone di avere un plug-in di connessione di analisi denominato P contenente una funzione personalizzata Calculate(Parameter1, Parameter2). La funzione restituisce la tabella Results contenente i campi Field1 e Field2. ``` Load * Extension P.Calculate( Values{A, C} ); ``` Carica tutti i campi restituiti quando si inviano i campi A e C alla funzione. ``` Load Field1 Extension P.Calculate( Values{A, C} ); ``` Carica solo il campo Field1 quando si inviano i campi A e C alla funzione. ``` Load * Extension P.Calculate( Values ); ``` Carica tutti i campi restituiti quando si inviano i campi A e B alla funzione. Dal momento che i campi non sono specificati, vengono utilizzati A e B, ossia i primi nell'ordine nella tabella. ``` Load * Extension P.Calculate( Values {C, C}); ``` Carica tutti i campi restituiti quando si invia il campo C a entrambi i parametri della funzione. Load \* Extension P.Calculate( Values {String(A), Mixed(B)}); Carica tutti i campi restituiti quando si invia il campo A forzato come stringa e il campo B forzato come numerico alla funzione. Caricamento di dati mediante valutazione di uno script Load A as A\_echo, B as B\_echo Extension R.ScriptEval( 'q;', Values{A, B} ); Carica la tabella restituita dallo script q quando si inviano i valori di A e B. Load \* Extension R.ScriptEval( '$(My\_R\_Script)', Values{A, B} ); Carica la tabella restituita dallo script memorizzata nella variabile My\_R\_Script quando si inviano i valori di A e B. Load \* Extension R.ScriptEval( '$(My\_R\_Script)', Values{B as D, \*} ); Carica la tabella restituita dallo script memorizzato nella variabile My\_R\_Script quando si inviano i valori di B rinominato in D, A e C. L'uso dell'asterisco (\*) consente di inviare i rimanenti campi senza riferimento. ## Ulteriori informazioni * [Voci per la specifica del formato](https://help.qlik.com/it-IT/qlikview/May2024/Subsystems/Client/Content/QV_QlikView/Scripting/ScriptSpecifiers/format-specification-items.htm)