Load

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.

Składnia:

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 ]

Argumenty:

Argumenty instrukcji load
Argument	Opis
distinct	Instrukcja distinct może być używana jako predykat dotyczący ładowania tylko unikatowych rekordów. Jeśli istnieją zduplikowane rekordy, wówczas załadowane zostanie tylko pierwsze wystąpienie. Jeśli używane są ładowania poprzedzające, wówczas distinct należy umieścić w pierwszej instrukcji ładowania, ponieważ distinct wpływa tylko na tabelę docelową.
fieldlist	fieldlist ::= ( * \| field {, field } ) Lista ładowanych pól. Użycie znaku * jako listy pól oznacza wszystkie pola w tabeli. field ::= ( fieldref \| expression ) [as aliasname ] Definicja pola musi zawsze zawierać literał, odniesienie do istniejącego pola lub wyrażenie. fieldref ::= ( fieldname \|@fieldnumber \|@startpos:endpos [ I \| U \| R \| B \| T] ) fieldname jest tekstem identycznym z nazwą pola w tabeli. Jeśli nazwa pola zawiera np. spacje, musi być ujęta w proste podwójne cudzysłowy lub nawiasy kwadratowe. Niekiedy nie są dostępne jawne nazwy pól. Wtedy należy użyć innego zapisu: @fieldnumber reprezentuje numer pola w rozdzielanym pliku tabeli. Musi to być dodatnia liczba całkowita poprzedzona znakiem „@”. Numeracja zawsze zaczyna się od 1, a kończy na liczbie pól. @startpos:endpos reprezentuje pozycję początkową i końcową pola w pliku z rekordami o stałej długości. Obie pozycje muszą być dodatnimi liczbami całkowitymi. Liczby muszą być poprzedzone znakiem „@” i rozdzielone dwukropkiem. Numeracja zawsze zaczyna się od 1, a kończy na liczbie pozycji. W ostatnim polu n jest używane jako pozycja końcowa. Jeśli bezpośrednio po zapisie @startpos:endpos następuje znak I lub U, odczytane bajty będą interpretowane jako dane binarne zawierające liczby całkowite, odpowiednio ze znakiem (I) lub bez znaku (U) (kolejność bajtów Intel). Liczba odczytanych pozycji musi wynosić 1, 2 lub 4. Jeśli bezpośrednio po zapisie @startpos:endpos następuje znak R, odczytane bajty będą interpretowane jako dane binarne zawierające liczby rzeczywiste (32-bitowe lub 64-bitowe wartości zmiennopozycyjne IEEE). Liczba odczytanych pozycji musi wynosić 4 lub 8. Jeśli bezpośrednio po zapisie @startpos:endpos następuje znak B, odczytane bajty będą interpretowane jako wartości BCD (Binary Coded Decimal) według standardu COMP-3. Można podać dowolną liczbę bajtów. expression może być funkcją liczbową lub znakową operującą na polach tej samej tabeli. Więcej informacji na ten temat zawiera sekcja na temat składni wyrażeń. Klauzula as służy do przypisania polu nowej nazwy.
from	Klauzula from umożliwia ładowanie danych z pliku. file ::= [ path ] filename bezwzględna Przykład: c:\data\ względna wobec ścieżki dokumentu QlikView. Przykład: data\ adres URL (HTTP lub FTP), wskazujący lokalizację w Internecie lub intranecie. Adres URL musi być kodowany za pomocą adresu URL, na przykład jeśli zawiera znaki spacji. Przykład: http://www.qlik.com Przykład: http://www.enterprise.com/project%20files (http://www.enterprise.com/project files) Pominięcie ścieżki spowoduje, że aplikacja QlikView będzie wyszukiwać plik w katalogu wskazanym instrukcją Directory. W razie braku instrukcji Directory aplikacja QlikView będzie szukać w katalogu roboczym, czyli zwykle w katalogu zawierającym plik QlikView. InformacjaW instalacji serwera QlikView domyślny katalog roboczy to C:\ProgramData\QlikTech\Documents. Domyślny katalog roboczy można modyfikować w aplikacji Konsola zarządzania QlikView. filename może zawierać standardowe symbole wieloznaczne DOS, czyli * i ?. Ich użycie spowoduje załadowanie wszystkich pasujących plików w określonym katalogu. format-spec ::= ( fspec-item { , fspec-item } ) Na specyfikację formatu składają się pozycje specyfikacji formatu podane w nawiasach jako lista. Directory From
from_field	from_field Klauzula umożliwia załadowanie danych z wcześniej załadowanego pola. fieldassource::=(tablename, fieldname) Wskazywana jest nazwa pola odpowiadająca nazwie wcześniej załadowanej tabeli tablename i nazwie pola fieldname. format-spec ::= ( fspec-item {, fspec-item } ) Na specyfikację formatu składają się pozycje specyfikacji formatu podane w nawiasach jako lista.
inline	Klauzula inline wskazuje dane wpisywane bezpośrednio w skrypcie, a nie ładowane z pliku. data ::= [ text ] Dane wprowadzane w ramach klauzuli inline muszą być ujęte w określone znaki — nawiasy kwadratowe, cudzysłowy lub grawisy. Tekst umieszczony między tymi znakami zostanie zinterpretowany tak samo, jak zawartość pliku. W związku z tym w tekście klauzuli inline należy wstawiać nowe wiersze w tych samych miejscach, w których występowałyby w pliku tekstowym, naciskając klawisz Enter podczas wpisywania skryptu. W prostym ładowaniu wbudowanym liczba kolumn jest określona w pierwszym wierszu. format-spec ::= ( fspec-item {, fspec-item } ) Ładowanie wbudowane można dostosować za pomocą wielu elementów specyfikacji formatu, które są dostępne dla innych załadowanych tabel. Elementy te podano w nawiasach. Więcej informacji zawiera temat Elementy specyfikacji formatu. Aby uzyskać więcej informacji o ładowaniu wbudowanym, zobacz temat Ładowanie danych z tabel wbudowanych.
resident	Klauzula resident umożliwia załadowanie danych z wcześniej załadowanej tabeli. table label to etykieta poprzedzająca instrukcje LOAD lub SELECT tworzące pierwotną tabelę. Na końcu etykiety musi się znajdować dwukropek. Kiedy używa się kombinacji instrukcji ładowania distinct i resident w QlikView 12.00 lub nowszej wersji, kolejność ładowania danych jest niższa niż w QlikView 11.20. Aby zdefiniować pożądaną kolejność ładowania, dodaj klauzulęorder by. Ładowanie danych z wcześniej załadowanej tabeli Etykiety tabeli
autogenerate	Klauzula autogenerate jest używana w przypadku danych, które mają być automatycznie generowane przez aplikację QlikView. size ::= number Number to liczba całkowita wskazująca liczbę generowanych rekordów. Lista pól nie może zawierać wyrażeń wymagających danych z bazy danych. W wyrażeniach dozwolone są jedynie stałe i funkcje bezparametrowe, na przykład rand() lub recno().
extension	Dane można ładować z połączeń analitycznych. Należy użyć klauzuli extension, aby wywołać funkcję zdefiniowaną we wtyczce rozszerzeń po stronie serwera (SSE) albo dokonać oceny skryptu. Do wtyczki SSE można wysłać pojedynczą tabelę i zostanie zwrócona pojedyncza tabela danych. Jeśli wtyczka nie określa nazw pól, które są zwracane, wówczas pola otrzymają nazwy Field1, Field2 itd. Extension pluginname.functionname( tabledescription ); Ładowanie danych za pomocą funkcji we wtyczce SSE tabledescription ::= (table { ,tablefield} ) Jeśli pola tabeli nie zostaną określone, wówczas pola będą używane w kolejności ładowania. Ładowanie danych poprzez ocenę skryptu we wtyczce SSE tabledescription ::= ( script, table { ,tablefield} ) Sposób obsługi typów danych w definicji pola tabeli Typy danych są automatycznie wykrywane w połączeniach analitycznych. Jeśli dane nie zawierają żadnych wartości liczbowych, a zawierają co najmniej jeden ciąg znaków inny niż NULL, wówczas takie pole jest traktowane jako tekstowe. W każdym innym przypadku jest traktowane jako liczbowe. Typ danych można wymusić, umieszczając nazwę pola w funkcji String() lub Mixed(). Funkcja String() wymusza traktowanie pola jako tekstowego. Jeśli pole jest liczbowe, wówczas wyodrębniana jest część tekstowa wartości podwójnej — nie jest wykonywane żadne przekształcenie. Funkcja Mixed() wymusza traktowanie pola jako podwójnego. Funkcje String() i Mixed() nie mogą być używane poza definicjami pola tabeli w klauzuli extension, a ponadto w definicji pola tabeli nie można używać innych funkcji QlikView. Więcej informacji o połączeniach analitycznych Informacje o tworzeniu połączenia analitycznego QlikView Server lub QlikView Desktop zawiera temat: Połączenia analityczne Więcej informacji na temat połączeń analitycznych zawiera repozytorium GitHub. qlik-oss/server-side-extension
where	where to klauzula określająca, czy rekord ma być uwzględniony w selekcji, czy też nie. Selekcja jest uwzględniana, jeśli warunek criterion ma wartość True. criterion jest wyrażeniem logicznym.
while	while to klauzula określająca, czy rekord ma być wielokrotnie odczytywany. Ten sam rekord będzie odczytywany, dopóki warunek criterion ma wartość True. W praktyce korzystanie z klauzuli while zwykle wymaga również użycia funkcji IterNo( ). criterion jest wyrażeniem logicznym.
group_by	Klauzula group by służy do określania pól, według których dane mają być agregowane (grupowane). Pola agregujące powinny być w jakiś sposób dołączone w ładowanych wyrażeniach. Poza obrębem funkcji agregacji w ładowanych wyrażeniach wolno używać wyłącznie pól agregujących. groupbyfieldlist ::= (fieldname { ,fieldname } )
order_by	Klauzula order by służy do sortowania rekordów tabeli rezydentnej przed ich przetworzeniem przez instrukcję load. Tabelę rezydentną można sortować według dowolnej liczby pól w kolejności rosnącej lub malejącej. Sortowanie jest wykonywane w pierwszej kolejności według wartości liczbowej, a w drugiej kolejności według porządku leksykograficznego z uwzględnieniem znaków diakrytycznych. Klauzuli można używać tylko wtedy, gdy źródłem danych jest tabela rezydentna. Pola porządkujące określają, według którego pola należy sortować tabelę rezydentną. Pole można wskazać nazwą lub numerem w tabeli rezydentnej (pierwsze pole ma numer 1). orderbyfieldlist ::= fieldname [ sortorder ] { , fieldname [ sortorder ] } Kolejność sortorder może mieć wartość asc (rosnąco) lub desc (malejąco). Jeśli nie określono sortorder, przyjmuje się wartość asc. fieldname, path, filename i aliasname to ciągi tekstowe reprezentujące odpowiednio nazwę pola, ścieżkę, nazwę pliku i alias. Jako fieldname można podać dowolne pole z tabeli źródłowej. Pola utworzone klauzulą as (aliasname) są jednak poza zakresem i nie można ich używać w tej samej instrukcji load.

Jeśli nie zostanie wskazane żadne źródło danych klauzulą from, inline, resident, from_field lub autogenerate, dane będą ładowane z wyniku instrukcji SELECT lub LOAD występującej bezpośrednio po bieżącej instrukcji. Następna instrukcja nie powinna mieć żadnego prefiksu.

Poprzedzające polecenie LOAD

Przykłady:

Załaduj rozdzielony plik danych z opcjami domyślnymi:

LOAD * from data1.csv;

Załaduj rozdzielony plik z przecinkiem jako znakiem rozdzielającym i z wbudowanymi etykietami:

LOAD * from 'c:\userfiles\data1.csv' (ansi, txt, delimiter is ',', embedded labels);

Załaduj rozdzielony plik z tabulacją jako znakiem rozdzielającym i z wbudowanymi etykietami:

LOAD * from 'c:\userfiles\data2.txt' (ansi, txt, delimiter is '\t', embedded labels);

Załaduj plik dif z wbudowanymi nagłówkami:

LOAD * from file2.dif (ansi, dif, embedded labels);

Załaduj trzy pola ze stałego pliku rekordu bez nagłówków:

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);

Załaduj plik QVX, określając ścieżkę bezwzględną:

LOAD * from C:\qdssamples\xyz.qvx (qvx);

Załaduj tylko trzy określone pola z rozdzielonego pliku:

LOAD FirstName, LastName, Number from data1.csv;

Zmień nazwę pierwszego pola na A, a drugiego na B podczas ładowania pliku bez etykiet:

LOAD @1 as A, @2 as B from data3.txt (ansi, txt, delimiter is '\t', no labels);

Załaduj Name jako konkatenację FirstName, znaku spacji i LastName:

LOAD FirstName&' '&LastName as Name from data1.csv;

Załaduj Quantity, Price i Value (wynik Quantity i Price):

LOAD Quantity, Price, Quantity*Price as Value from data1.csv;

Załaduj tylko unikatowe rekordy (powielone rekordy zostaną zignorowane):

LOAD distinct FirstName, LastName, Number from data1.csv;

Załaduj tylko te rekordy, w których pole Litres ma wartość powyżej zera:

LOAD * from Consumption.csv where Litres>0;

Załaduj tabelę z danymi wbudowanymi, dwoma polami o nazwach CatID i Category:

LOAD * Inline

[CatID, Category

0,Regular

1,Occasional

2,Permanent];

Załaduj tabelę z danymi wbudowanymi, trzema polami o nazwach UserID, Password i Access:

LOAD * Inline [UserID, Password, Access

A, ABC456, User

B, VIP789, Admin];

Załaduj tabelę z 10 000 wierszami. Pole A będzie zawierać numer odczytanego rekordu (1,2,3,4,5...), a pole B losową liczbę między 0 i 1:

LOAD RecNo( ) as A, rand( ) as B autogenerate(10000);

Nawiasy po autogenerate są dozwolone, ale niewymagane.

Najpierw ładujemy rozdzielony plik tabeli i nadajemy mu nazwę tab1:

tab1:

SELECT A,B,C,D from transtable;

Załaduj pola z wcześniej załadowanej tabeli tab1 jako tab2:

tab2:

LOAD A,B,month(C),A*B+D as E resident tab1;

Załaduj pola z wcześniej załadowanej tabeli tab1, ale tylko rekordy, w których wartość A jest większa niż B:

tab3:

LOAD A,A+B+C resident tab1 where A>B;

Załaduj pola z wcześniej załadowanej tabeli tab1 uporządkowane według A:

LOAD A,B*C as E resident tab1 order by A;

Załaduj pola z wcześniej załadowanej tabeli tab1, uporządkowane według pierwszego pola, a następnie drugiego pola:

LOAD A,B*C as E resident tab1 order by 1,2;

Załaduj pola z wcześniej załadowanej tabeli tab1 uporządkowane według C malejąco, a następnie B rosnąco, po czym według pierwszego pola malejąco:

LOAD A,B*C as E resident tab1 order by C desc, B asc, 1 des;

Załaduj Types pól z wcześniej załadowanej tabeli Characters jako A:

LOAD A from_field (Characters, Types);

Załaduj A, B oraz obliczone pola X i Y z tabeli Table1 ładowanej w następnej instrukcji SELECT:

LOAD A, B, if(C>0,'positive','negative') as X, weekday(D) as Y;

SELECT A,B,C,D from Table1;

Poprzedzające polecenie LOAD

Załaduj pola pogrupowane (zagregowane) według ArtNo:

LOAD ArtNo, round(Sum(TransAmount),0.05) as ArtNoTotal from table.csv group by ArtNo;

Załaduj pola pogrupowane (zagregowane) według Week i ArtNo:

LOAD Week, ArtNo, round(Avg(TransAmount),0.05) as WeekArtNoAverages from table.csv group by Week, ArtNo;

W tym przykładzie mamy plik wejściowy Grades.csv zawierający oceny wszystkich uczniów zebrane w jednym polu:

Student,Grades

Mike,5234

John,3345

Pete,1234

Paul,3352

Oceny, w skali od 1 do 5, reprezentują następujące przedmioty: Math, English, Science i History. Możemy rozdzielić oceny w oddzielne wartości, kilkakrotnie odczytując każdy rekord z klauzulą while przy użyciu funkcji IterNo( ) jako licznika. W każdym odczycie ocena jest wyodrębniana przy użyciu funkcji Mid i zapisywana w Grade, a temat jest wybierany za pomocą funkcji pick i zapisywany w Subject. Ostatnia klauzula while zawiera test celem sprawdzenia, czy wszystkie oceny zostały odczytane (w tym przypadku cztery na ucznia), co oznacza, że należy odczytać rekord następnego ucznia.

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));

W efekcie otrzymuje się tabelę zawierającą następujące dane:

A table containing data for Students, Subjects, and Grades.

Używane są następujące dane przykładowe.

Values: Load Rand() as A, Rand() as B, Rand() as C AutoGenerate(50);

Ładowanie danych za pomocą funkcji

W tych przykładach zakładamy, że mamy wtyczkę połączeń analitycznych o nazwie P, która zawiera funkcję niestandardową Calculate(Parameter1, Parameter2). Ta funkcja zwraca tabelę Results, która zawiera pola Field1 i Field2.

Load * Extension P.Calculate( Values{A, C} );

Załaduj wszystkie pola zwracane podczas wysyłania pól A i C do funkcji.

Load Field1 Extension P.Calculate( Values{A, C} );

Załaduj tylko pole Field1 podczas wysyłania pól A i C do funkcji.

Load * Extension P.Calculate( Values );

Załaduj wszystkie pola zwracane podczas wysyłania pól A i B do funkcji. Pola nie są określone, dlatego używane są pola A i B, ponieważ są pierwsze w kolejności w tabeli.

Load * Extension P.Calculate( Values {C, C});

Załaduj wszystkie pola, które są zwracane po wysłaniu pola C do obu parametrów funkcji.

Load * Extension P.Calculate( Values {String(A), Mixed(B)});

Załaduj wszystkie pola zwracane w przypadku wysłania do funkcji pola A, względem którego wymuszono traktowanie go jako ciągu znaków, oraz pola B, względem którego wymuszono traktowanie go jako liczbowego.

Ładowanie danych poprzez ocenę skryptu

Load A as A_echo, B as B_echo Extension R.ScriptEval( 'q;', Values{A, B} );

Załaduj tabelę zwracaną przez skrypt q w przypadku wysłania wartości A i B.

Load * Extension R.ScriptEval( '$(My_R_Script)', Values{A, B} );

Załaduj tabelę zwracaną przez skrypt zapisywany w zmiennej My_R_Script w przypadku wysłania wartości A i B.

Load * Extension R.ScriptEval( '$(My_R_Script)', Values{B as D, *} );

Załaduj tabelę zwracaną przez skrypt zapisywany w zmiennej My_R_Script w przypadku wysłania wartości B, której nazwę zmieniono na D, A i C. Użycie * powoduje wysłanie pozostałych pól, do których nie istnieją odwołania.

Dowiedz się więcej

Elementy specyfikacji formatu

Czy ta strona była pomocna?

Jeżeli natkniesz się na problemy z tą stroną lub jej zawartością — literówkę, brakujący krok lub błąd techniczny — daj nam znać, co możemy poprawić!

Przekaż tu opinię

Load

Dowiedz się więcej

Czy ta strona była pomocna?

Dołącz do Programu Modernizacji Analityki