Istruzioni regolari dello script
Le istruzioni regolari vengono generalmente utilizzate per la manipolazione dei dati. Queste istruzioni possono essere scritte su un qualsiasi numero di righe nello script e devono sempre terminare con un punto e virgola, ";".
Tutte le parole chiave dello script possono essere immesse con qualsiasi combinazione di caratteri maiuscoli e minuscoli. I nomi dei campi e delle variabili utilizzati nelle istruzioni possono essere immessi indipendentemente dal formato del carattere.
Utilizzare l'elenco a discesa su ciascuna funzione per visualizzare una breve descrizione e la sintassi di ciascuna funzione. Per ulteriori informazioni, fare clic sul nome della funzione nella descrizione della sintassi.
L'istruzione alias viene utilizzata per impostare un alias in base al quale verrà rinominato un campo quando questo ricorrerà nello script che segue.
Alias fieldname as aliasname {,fieldname as aliasname}
Questa istruzione crea un valore intero univoco per ciascun valore calcolato distinto in un campo rilevato durante l'esecuzione dello script.
Autonumber fields [Using namespace] ]
L'istruzione binary consente di caricare i dati da un altro documento QlikView, inclusi i dati in Section Access.
Binary [path] filename
Fornisce un modo per visualizzare i commenti dei campi (metadati) da database e fogli di calcolo. I nomi di campo non presenti nell'app verranno ignorati. In caso di più ricorrenze di uno stesso nome di campo, verrà applicato l'ultimo valore utilizzato.
comment *fieldlist using mapname
comment fieldname with comment
Fornisce un modo per visualizzare i commenti delle tabelle (metadati) da database o fogli di calcolo.
comment-table tablelist using mapname
comment-table tablename with comment
L'istruzione CONNECT consente di definire l'accesso di Qlik Sense a un database generico mediante l'interfaccia OLE DB/ODBC. Per ODBC, occorre innanzitutto specificare la sorgente dati utilizzando l'amministratore ODBC.
ODBC CONNECT TO connect-string [ ( access_info ) ]
OLEDB CONNECT TO connect-string [ ( access_info ) ]
CUSTOM CONNECT TO connect-string [ ( access_info ) ]
LIB CONNECT TO connection
L'istruzione Declare consente di creare definizioni di campo in cui è possibile definire relazioni tra i campi o le funzioni. È possibile utilizzare una serie di definizioni di campo per generare automaticamente campi derivati, che possono essere utilizzati come dimensioni. Ad esempio, è possibile creare una definizione di calendario e utilizzarla per generare dimensioni correlate, come ad esempio anno, mese, settimana e giorno da un campo della data.
definition_name:
Declare [Field[s]] Definition [Tagged tag_list ]
[Parameters parameter_list ]
Fields field_list
[Groups group_list ]
<definition name>:
Declare [Field][s] Definition
Using <existing_definition>
[With <parameter_assignment> ]
L'istruzione Derive consente di generare campi derivati in base a una definizione di campo creata mediante un'istruzione Declare. È possibile specificare i campi dati per cui derivare i campi oppure derivarli esplicitamente o implicitamente in base ai tag di campo.
Derive [Field[s]] From [Field[s]] field_list Using definition
Derive [Field[s]] From Explicit [Tag[s]] (tag_list) Using definition
Derive [Field[s]] From Implicit [Tag[s]] Using definition
L'istruzione DIRECT QUERY consente di accedere alle tabelle mediante una connessione ODBC o OLE DB utilizzando la funzione Direct Discovery.
direct-query [path]
L'istruzione Directory definisce in quale directory ricercare i file dei dati nelle istruzioni LOAD successive finché non viene eseguita una nuova istruzione Directory.
Directory [path]
L'istruzione Disconnect termina l'attuale connessione ODBC/OLE DB/Personalizzata. Questa istruzione è opzionale.
Durante l'esecuzione dello script, in qualsiasi momento è possibile rilasciare dal modello dati e quindi dalla memoria uno o più campi di Qlik Sense utilizzando l'istruzione drop field. La proprietà "distinct" di una tabella viene rimossa dopo un'istruzione drop field.
drop-field fieldname [ , fieldname2 ...] [from tablename1 [ , tablename2 ...]]
drop fields fieldname [ , fieldname2 ...] [from tablename1 [ , tablename2 ...]]
Durante l'esecuzione dello script, è possibile rilasciare dal modello dati, e quindi dalla memoria, una o più tabelle interne di Qlik Sense utilizzando l'istruzione drop table.
drop-table tablename [, tablename2 ...]
drop tables[ tablename [, tablename2 ...]
L'istruzione Execute viene utilizzata per eseguire altri programmi, mentre Qlik Sense sta caricando i dati. Ad esempio, per effettuare le connessioni necessarie.
Execute commandline
L'istruzione FlushLog obbliga Qlik Sense a scrivere il contenuto del buffer dello script nel file di registro dello script.
L'istruzione force impone a Qlik Sense di interpretare i nomi e i valori di campo delle istruzioni LOAD e SELECT successive in formato solo maiuscolo, solo minuscolo, sempre maiuscolo o conformemente alla visualizzazione attuale (formato misto). Questa istruzione permette di associare i valori di campo provenienti da tabelle create in base a convenzioni differenti.
Force ( capitalization | case upper | case lower | case mixed )
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. È anche possibile caricare dati da connessioni di analisi.
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 ]
[extension pluginname.functionname(tabledescription)]
L'istruzione let è un complemento all'istruzione set, utilizzata per definire le variabili degli script. L’istruzione let, a differenza dell’istruzione set, valuta l’espressione posta sul lato destro del simbolo '=' al tempo di esecuzione dello script prima dell'assegnazione alla variabile.
Let variablename=expression
Una o più tabelle dati interne di Qlik Sense possono essere dichiarate logicamente disconnesse in modo esplicito durante l'esecuzione dello script, utilizzando un'istruzione Loosen Table. Quando una tabella è logicamente disconnessa, tutte le associazioni tra i valori di campo nella tabella vengono rimosse. È possibile ottenere un effetto simile caricando ogni campo della tabella logicamente disconnessa come tabelle indipendenti e scollegate. La disconnessione logica può rivelarsi utile durante il controllo per isolare temporaneamente parti differenti della struttura dei dati. Nel visualizzatore tabelle è possibile riconoscere una tabella logicamente disconnessa dalle linee punteggiate. L'utilizzo di una o più istruzioni Loosen Table nello script indica a Qlik Sense di ignorare ogni impostazione di tabelle logicamente disconnesse effettuata prima dell'esecuzione dello script.
tablename [ , tablename2 ...]
Loosen Tables tablename [ , tablename2 ...]
L'istruzione map ... using viene usata per eseguire il mapping di un certo valore di campo o una certa espressione sui valori di una tabella di mapping specifica. La tabella di mapping viene creata utilizzando l'istruzione Mapping.
Map *fieldlist Using mapname
L'istruzione NullAsNull disattiva la conversione dei valori NULL in valori di stringa impostati in precedenza da un'istruzione NullAsValue.
NullAsNull *fieldlist
L'istruzione NullAsValue specifica per quali campi NULL deve essere convertito in un valore.
NullAsValue *fieldlist
L'istruzione Qualify consente di modificare la qualificazione dei nomi di campo, ad esempio il nome della tabella dei nomi di campo diventerà un prefisso.
Qualify *fieldlist
L'istruzione rem viene utilizzata per inserire osservazioni, o commenti, negli script o per disattivare temporaneamente istruzioni dello script senza rimuoverle.
Rem string
Questa funzione di script rinomina uno o più campi di Qlik Sense esistenti dopo che sono stati caricati.
rename-field (using mapname | oldname to newname{ , oldname to newname })
Rename Fields (using mapname | oldname to newname{ , oldname to newname })
Questa funzione di script rinomina una o più tabelle interne di Qlik Sense esistenti dopo che sono state caricate.
rename-table (using mapname | oldname to newname{ , oldname to newname })
Rename Tables (using mapname | oldname to newname{ , oldname to newname })
L'istruzione section consente di definire se le istruzioni successive LOAD e SELECT devono essere considerate come dati o come una definizione dei diritti di accesso.
Section (access | application)
La selezione dei campi da una sorgente dati ODBC o da un provider OLE DB viene eseguita utilizzando le istruzioni SQL SELECT standard. Tuttavia, l'ambito nel quale le istruzioni SELECT vengono accettate dipende dal driver ODBC o dal provider OLE DB utilizzato.
Select [all | distinct | distinctrow | top n [percent] ] *fieldlist
From tablelist
[Where criterion ]
[Group by fieldlist [having criterion ] ]
[Order by fieldlist [asc | desc] ]
[ (Inner | Left | Right | Full)Join tablename on fieldref = fieldref ]
L'istruzione set viene utilizzata per definire le variabili di script. Le variabili possono essere utilizzate per sostituire stringhe, percorsi, unità e così via.
Set variablename=string
L'istruzione sleep interrompe l'esecuzione dello script per il periodo di tempo specificato.
Sleep n
L'istruzione SQL consente di inviare un comando arbitrario SQL tramite una connessione ODBC o OLE DB.
SQL sql_command
L'istruzione sqlcolumns restituisce un gruppo di campi che descrivono le colonne di una sorgente dati ODBC o OLE DB sulla quale è stata eseguita un'istruzione connect.
L'istruzione sqltables restituisce un gruppo di campi che descrivono le tabelle di una sorgente dati ODBC o OLE DB sulla quale è stata eseguita un'istruzione connect.
L'istruzione sqltypes restituisce un gruppo di campi che descrivono i tipi di una sorgente dati ODBC o OLE DB sulla quale è stata eseguita un'istruzione connect.
La stringa utilizzata per rappresentare l'insieme di tutti i valori di un campo nel database può essere impostata tramite l'istruzione star. Interessa le istruzioni LOAD e SELECT successive.
Star is [ string ]
L'istruzione Store crea un file QVD, o text.
Store [ *fieldlist from] table into filename [ format-spec ];
Questa istruzione dello script fornisce un modo per assegnare tag a uno o più campi o tabelle. Se viene effettuato un tentativo di contrassegnare un campo o una tabella non presente nell'app, tale contrassegno verrà ignorato. In caso di conflitto nelle ricorrenze di un nome di campo o di tag, si utilizza l'ultimo valore trovato.
Tag[field|fields] fieldlist with tagname
Tag [field|fields] fieldlist using mapname
Tag table tablelist with tagname
L'istruzione trace esegue la scrittura di una stringa nella finestra Avanzamento dell'esecuzione dello script e nel file di log dello script, quando viene utilizzato. Si rivela molto utile per le operazioni di debug. L'uso delle espansioni $ delle variabili calcolate prima dell'istruzione trace consente di personalizzare il messaggio.
Trace string
L'istruzione Unmap disattiva il mapping del valore di campo specificato da un'istruzione Map … Using precedente per i campi caricati successivamente.
Unmap *fieldlist
L'istruzione Unqualify viene utilizzata per disattivare la qualificazione dei nomi di campo che era stata precedentemente attivata dall'istruzione Qualify.
Unqualify *fieldlist
Questa istruzione dello script fornisce un modo per rimuovere tag da campi o tabelle. Se viene effettuato un tentativo di rimozione di un contrassegno da un campo o una tabella non presente nell'app, tale rimozione verrà ignorata.
Untag[field|fields] fieldlist with tagname
Tag [field|fields] fieldlist using mapname
Tag table tablelist with tagname