Zwykłe instrukcje skryptu
Zwykłe instrukcje służą zazwyczaj do wykonywania operacji na danych. Każda taka instrukcja może obejmować w skrypcie dowolną liczbę wierszy i musi zawsze być zakończona średnikiem, czyli znakiem „;”.
Słowa kluczowe w skrypcie mogą być wpisywane z użyciem dowolnych kombinacji małych i wielkich liter. Wielkość liter jest natomiast uwzględniana w nazwach pól i zmiennych używanych w instrukcjach.
Przy każdej funkcji znajduje się pole rozwijane umożliwiające wyświetlenie składni i krótkiego opisu funkcji. Kliknij nazwę funkcji w opisie składni, aby uzyskać więcej informacji.
Instrukcja alias służy do ustawiania aliasu, który będzie używany jako nazwa pola we wszystkich wystąpieniach tego pola w skrypcie.
Alias fieldname as aliasname {,fieldname as aliasname}
Ta instrukcja zwraca niepowtarzalną wartość całkowitą dla każdej odrębnie przetwarzanej wartości w polu napotkanym podczas wykonywania skryptu.
Autonumber fields [Using namespace] ]
Instrukcja binary służy do ładowania danych z innego dokumentu QlikView, w tym danych z instrukcji Section Access.
Binary [path] filename
Udostępnia sposób wyświetlania komentarzy do tabeli (metadanych) z baz danych lub arkuszy kalkulacyjnych.
comment-table tablelist using mapname
comment-table tablename with comment
Instrukcja CONNECT służy do określania dostępu aplikacji Qlik Sense do ogólnej bazy danych przy użyciu interfejsu OLE DB/ODBC. W przypadku ODBC źródło danych najpierw należy określić za pomocą narzędzia administracyjnego 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
Instrukcja Declare służy do tworzenia definicji pól, w których można określić relacje między polami a funkcjami. Definicje zestawów pól można wykorzystać do automatycznego generowania pochodnych pól, których można użyć jako wymiarów. Można na przykład utworzyć definicję kalendarza i użyć jej do wygenerowania z pola daty powiązanych wymiarów takich jak rok, miesiąc, tydzień i dzień.
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> ]
Instrukcja Derive służy do generowania pochodnych pól na podstawie definicji pola utworzonej przy użyciu instrukcji Declare. Można określić, dla których pól danych mają być tworzone pochodne pola, lub tworzyć je jawnie lub niejawnie na podstawie znaczników pól.
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
Instrukcja DIRECT QUERY umożliwia uzyskanie dostępu do tabel za pośrednictwem połączenia ODBC lub OLE DB przy użyciu funkcji aplikacji Direct Discovery.
direct-query [path]
Instrukcja Directory określa, w którym katalogu należy szukać plików danych w kolejnych instrukcjach LOAD, do momentu wydania nowej instrukcji Directory.
Directory [path]
Instrukcja Disconnect przerywa bieżące połączenieODBC/OLE DB/Niestandardowe. Ta instrukcja jest opcjonalna.
W dowolnym momencie podczas wykonywania skryptu można usunąć z modelu danych, a zarazem z pamięci, pola aplikacji Qlik Sense, korzystając w tym celu z instrukcji drop field.
drop-field fieldname [ , fieldname2 ...] [from tablename1 [ , tablename2 ...]]
drop fields fieldname [ , fieldname2 ...] [from tablename1 [ , tablename2 ...]]
W dowolnym momencie podczas wykonywania skryptu można usunąć z modelu danych, a zarazem z pamięci, wewnętrzne tabele aplikacji Qlik Sense, korzystając w tym celu z instrukcji drop table.
drop-table tablename [, tablename2 ...]
drop tables[ tablename [, tablename2 ...]
Instrukcja Execute służy do uruchamiania innych programów w czasie, gdy aplikacja Qlik Sense ładuje dane. Na przykład w celu wykonania niezbędnych przekształceń.
Execute commandline
Instrukcja FlushLog wymusza w aplikacji Qlik Sense zapisywanie zawartości bufora skryptu do pliku dziennika skryptu.
Instrukcja force wymusza w aplikacji Qlik Sense interpretację nazw i wartości pól kolejnych instrukcji LOAD i SELECT jako pisanych tylko wielkimi literami, tylko małymi literami, jak nazwy własne lub tak, jak są wyświetlane (mieszane). Ta instrukcja umożliwia powiązanie wartości pól z tabeli utworzonych zgodnie z różnymi konwencjami.
Force ( capitalization | case upper | case lower | case mixed )
Instrukcja LOAD ładuje pola z pliku, z danych zdefiniowanych w skrypcie, z wcześniej załadowanej tabeli, ze strony internetowej, z wyniku późniejszej instrukcji SELECT lub przez automatyczne wygenerowanie danych. Możliwe jest również ładowanie danych z połączeń analitycznych.
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)]
Instrukcja let, uzupełniająca instrukcję set, służy do określania zmiennych skryptu. Instrukcja let w przeciwieństwie do instrukcji set ocenia wyrażenie po prawej stronie znaku „=” w czasie wykonywania skryptu, zanim zostanie przypisane do zmiennej.
Let variablename=expression
Instrukcja Loosen Table umożliwia jawne deklarowanie wewnętrznych tabel danych Qlik Sense jako luźno powiązanych na etapie wykonywania skryptu. Gdy tabela jest luźno powiązana, wszystkie asocjacje między wartościami pola w tabeli są usuwane. Podobny efekt można uzyskać przez załadowanie poszczególnych pól luźno powiązanej tabeli jako niezależnych, niepołączonych tabel. Luźne powiązanie może być użyteczne podczas testowania w celu tymczasowego izolowania różnych części struktury danych. Luźno powiązaną tabelę można zidentyfikować w przeglądarce tabel na podstawie linii przerywanych. Jeśli w skrypcie występuje jakakolwiek instrukcja Loosen Table, aplikacja Qlik Sense zignoruje wszelkie ustawienia tabel luźno powiązanych obowiązujące przed wykonaniem skryptu.
tablename [ , tablename2 ...]
Loosen Tables tablename [ , tablename2 ...]
Instrukcja map ... using służy do mapowania określonej wartości pola lub wyrażenia na wartości we wskazanej tabeli mapowania. Tabelę mapowania tworzy się instrukcją Mapping.
Map *fieldlist Using mapname
Instrukcja NullAsNull wyłącza konwersję wartości NULL na wartości ciągów znaków ustawione wcześniej przez instrukcję NullAsValue.
NullAsNull *fieldlist
Instrukcja NullAsValue określa, dla których pól wartość NULL powinna być przekształcona w wartość.
NullAsValue *fieldlist
Instrukcja Qualify służy do przełączania kwalifikacji nazw pól, na przykład aby nazwy te przyjmowały jako prefiks nazwę tabeli.
Qualify *fieldlist
Instrukcja rem służy do wstawiania komentarzy do skryptu lub tymczasowego dezaktywowania instrukcji w skrypcie bez usuwania ich.
Rem string
Ta funkcja skryptu zmienia nazwy istniejących pól aplikacji Qlik Sense po ich załadowaniu.
rename-field (using mapname | oldname to newname{ , oldname to newname })
Rename Fields (using mapname | oldname to newname{ , oldname to newname })
Ta funkcja skryptu zmienia nazwy istniejących tabel wewnętrznych aplikacji Qlik Sense po ich załadowaniu.
rename-table (using mapname | oldname to newname{ , oldname to newname })
Rename Tables (using mapname | oldname to newname{ , oldname to newname })
Instrukcja section pozwala określić, czy następujące po niej instrukcje LOAD i SELECT mają być traktowane jako dane czy jako definicje praw dostępu.
Section (access | application)
Pola są wybierane ze źródła danych ODBC lub dostawcy OLE DB z użyciem standardowych instrukcji SELECT języka SQL. Akceptacja instrukcji SELECT zależy jednak od używanego sterownika ODBC lub dostawcy OLE DB.
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 ]
Instrukcja set jest używana do określania zmiennych skryptu. Mogą one służyć do zastępowania ciągów znaków, ścieżek, dysków itp.
Set variablename=string
Instrukcja sleep wstrzymuje wykonanie skryptu przez określony czas.
Sleep n
Instrukcja SQL umożliwia wysłanie dowolnego polecenia SQL przez połączenie ODBC lub OLE DB.
SQL sql_command
Instrukcja sqlcolumns zwraca zestaw pól opisujących kolumny źródła danych ODBC lub OLE DB, do którego utworzono połączenie connect.
Instrukcja sqltables zwraca zestaw pól opisujących tabele źródła danych ODBC lub OLE DB, do którego utworzono połączenie connect.
Instrukcja sqltypes zwraca zestaw pól opisujących typy źródła danych ODBC lub OLE DB, do którego utworzono połączenie connect.
Ciąg danych używany na potrzeby reprezentacji zestawu wszystkich wartości pola w bazie danych można ustawić przy użyciu instrukcji star. Wpływa on na następne instrukcje LOAD i SELECT.
Star is [ string ]
Instrukcja Store tworzy plik QVD lub text.
Store [ *fieldlist from] table into filename [ format-spec ];
Ta instrukcja skryptu umożliwia przypisywanie znaczników do jednego lub większej liczby pól lub tabel. W przypadku próby oznaczenia pola lub tabeli niewystępującej w aplikacji oznaczanie zostanie zignorowane. W przypadku znalezienia niezgodnych wystąpień pola lub znacznika używana jest ostatnia wartość.
Tag[field|fields] fieldlist with tagname
Tag [field|fields] fieldlist using mapname
Tag table tablelist with tagname
Instrukcja trace zapisuje ciąg znaków w oknie Postęp wykonania skryptu oraz w pliku dziennika skryptu (jeśli jest używany). Może być bardzo przydatna do celów debugowania. Komunikat taki można dostosować przy użyciu rozszerzeń „$” zmiennych obliczanych przed instrukcją trace.
Trace string
Instrukcja Unmap powoduje dezaktywację mapowania wartości pola określonej w poprzedniej instrukcji Map … Using dla kolejno ładowanych pól.
Unmap *fieldlist
Instrukcja Unqualify służy do wyłączania kwalifikowania nazw pól, które zostało wcześniej włączone przy użyciu instrukcji Qualify.
Unqualify *fieldlist
Ta instrukcja skryptu umożliwia usuwanie znaczników z pól lub tabel. W przypadku próby usunięcia oznaczenia pola lub tabeli niewystępującej w aplikacji usunięcie oznaczenia zostanie zignorowane.
Untag[field|fields] fieldlist with tagname
Tag [field|fields] fieldlist using mapname
Tag table tablelist with tagname