Load

Der LOAD-Befehl lädt Felder aus einer Datei aus Daten, die im Skript definiert sind, aus einer zuvor geladenen Tabelle, aus einer Webseite, aus dem Ergebnis eines nachfolgenden SELECT-Befehls oder durch automatisches Generieren der Daten. Daten können auch aus Analyseverbindungen geladen werden.

Syntax:

LOAD [ distinct ] fieldlist

[( from file [ format-spec ] |

from_field fieldassource [format-spec]|

inline data [ format-spec ] |

resident table-label |

autogenerate size ) |extension pluginname.functionname([script] tabledescription)]

[ where criterion | while criterion ]

[ group by groupbyfieldlist ]

[order by orderbyfieldlist ]

Argumente:

Argumente
Argument	Beschreibung
distinct	Sie können distinct als Prädikat verwenden, wenn Sie nur eindeutige Datensätze laden möchten. Wenn duplizierte Datensätze vorhanden sind, wird die erste Instanz geladen. Wenn Sie vorangehende Ladevorgänge verwenden, müssen Sie distinct in den ersten load-Befehl platzieren, da distinct nur die Zieltabelle betrifft. Vorangehender Load-Befehl
fieldlist	fieldlist ::= ( * \| field{, * \| field } ) Liste der zu ladenden Felder. * in einer Felderliste bedeutet alle Felder in der Tabelle. field ::= ( fieldref \| expression ) [as aliasname ] Die Felddefinition muss immer eine Literale enthalten, einen Verweis auf ein bestehendes Feld oder eine Formel. fieldref ::= ( fieldname \|@fieldnumber \|@startpos:endpos [ I \| U \| R \| B \| T] ) Dabei ist fieldname ein Text, der einem Feldnamen in der Tabelle entspricht. Beachten Sie, dass der Feldname zwischen geraden doppelten Anführungszeichen oder eckigen Klammern stehen muss, wenn er beispielsweise Leerzeichen enthält. Mitunter sind Feldnamen nicht im Tabellenkopf verfügbar. Verwenden Sie in diesem Fall stattdessen folgende Notation: @fieldnumber bezeichnet die Nummer des Feldes in einer Textdatei mit Trennzeichen. Es muss eine ganze positive Zahl mit vorangehendem "@" sein. Die Nummerierung beginnt stets mit 1 und endet mit der Gesamtzahl der Felder. @startpos:endpos bezeichnet Start- und Endposition eines Feldes in einer Datei mit festen Satzlängen. Die Positionen müssen beide positive ganze Zahlen sein. Beiden Zahlen muss ein "@" vorangehen und sie müssen durch einen Doppelpunkt getrennt sein. Die Nummerierung beginnt stets mit 1 und geht bis zu der entsprechenden Zahl von Stellen. Im letzten Feld wird n als Endposition verwendet. Folgt direkt hinter @startpos:endpos der Buchstabe I oder U, werden die eingelesenen Daten als binär codierte ganze Zahl mit Vorzeichen (I) bzw. als binär codierte ganze Zahl ohne Vorzeichen U (Intel Byte Order) interpretiert. Die Zahl der eingelesenen Positionen muss 1, 2 oder 4 betragen. Folgt direkt hinter @startpos:endpos der Buchstabe R, werden die eingelesenen Daten als binär codierte reelle Zahlen (IEEE 32-Bit- oder 64-Bit-Gleitkommazahl) interpretiert. Die Zahl der eingelesenen Positionen muss 4 oder 8 betragen. Folgt direkt hinter @startpos:endpos der Buchstabe B, werden die eingelesenen Daten als binär codierte Dezimalzahlen BCD (Binary Coded Decimal) entsprechend dem COMP-3-Standard interpretiert. Es kann eine beliebige Zahl von Bytes angegeben werden. expression kann eine numerische Funktion oder eine Stringfunktion sein, die sich auf ein oder mehrere Felder derselben Tabelle bezieht. Weitere Informationen finden Sie in den Erläuterungen der Formel-Syntax. Der Zusatz as weist dem Feld einen neuen Namen zu.
from	from wird verwendet, um Daten aus einer Datei mithilfe eines Ordners zu laden. file ::= [ path ] filename Persönlicher Bereich: [lib://DataFiles/xyz.qvd] Sie können keine Ordnerhierarchie erstellen oder referenzieren, wenn Sie die Verbindung DataFiles verwenden. Beispielsweise wird Folgendes nicht unterstützt: [lib://DataFiles/subfolder1/xyz.qvd] Freigegebener Bereich: [lib://TeamSharedSpace:DataFiles/xyz.qvd]
from_field	Der Zusatz from_field wird benutzt, um Daten aus einem bereits geladenen Feld zu laden. fieldassource::=(tablename, fieldname) Das Feld wird durch tablename und fieldname definiert. format-spec ::= ( fspec-item {, fspec-item } ) Die Formatbezeichnung besteht aus einer Auflistung von Formatoptionen, die in Klammern stehen. Weitere Informationen finden Sie unter Formatoptionen. Informationshinweisfrom_field unterstützt nur Kommas als Listentrennzeichen, wenn Felder in Tabellen getrennt werden.
inline	Der Zusatz inline wird benutzt, wenn Daten direkt in das Skript eingegeben und nicht aus einer Datei geladen werden sollen. data ::= [ text ] Daten, die durch eine inline-Bedingung in das Skript eingefügt werden, müssen in doppelten Anführungszeichen oder in eckigen Klammern stehen. Der Text wird auf die gleiche Weise interpretiert wie der Inhalt einer Datei, d. h. er sollte auch genauso aufgebaut sein. Wenn Sie beispielsweise in einer Textdatei eine neue Zeile beginnen würden, sollten Sie dies auch im Text eines inline-Befehls durch Drücken der ENTER-Taste tun. Die Anzahl der Spalten wird durch die erste Zeile definiert. format-spec ::= ( fspec-item {, fspec-item } ) Die Formatbezeichnung besteht aus einer Auflistung von Formatoptionen, die in Klammern stehen. Weitere Informationen finden Sie unter Formatoptionen.
resident	Der Zusatz resident wird benutzt, um Daten aus einer bereits geladenen Tabelle zu laden. table label ist die Bezeichnung, die dem LOAD- oder SELECT-Befehl vorangeht, durch den die Tabelle erstellt wurde. Am Ende des resident-Zusatzes sollte ein Doppelpunkt stehen. Laden von Daten aus bereits geladenen Tabellen Tabellenbezeichnungen
autogenerate	Der Zusatz autogenerate wird benutzt, um Daten automatisch durch Qlik Sense generieren zu lassen. size ::= number Number steht für eine ganze Zahl, die bezeichnet, wie viele Datensätze angelegt werden sollen. Die Feldliste darf keine Formeln enthalten, die Daten aus einer externen Datenquelle oder einer zuvor geladenen Tabelle enthalten, es sei denn, Sie nehmen auf einen einzigen Feldwert in einer zuvor geladenen Tabelle mit der Funktion Peek Bezug.
where	where wird benutzt, um anhand eines Kriteriums zu prüfen, ob der Datensatz geladen wird oder nicht. Ist criterion True, wird der Datensatz geladen. criterion ist eine logische Formel.
while	Der Zusatz while dient dazu, einen Datensatz mehrfach zu laden. Der Datensatz wird solange eingelesen, wie criterion True ist. Sinnvollerweise schließt ein while-Zusatz die Funktion IterNo( ) ein. criterion ist eine logische Formel.
group by	Der Zusatz group by bestimmt, nach welchen Feldern die Daten aggregiert (gruppiert) werden sollen. Die Aggregierungsfelder sollten in den geladenen Formeln verwendet werden. Außerhalb von Aggregierungsfunktionen dürfen in load-Befehlen mit group by-Zusatz nur die im group by-Zusatz aufgeführten Felder geladen werden. groupbyfieldlist ::= (fieldname { ,fieldname } )
order by	Der Zusatz order by kann nur in load-Befehlen mit resident-Zusatz benutzt werden, d. h. wenn Daten aus einer bereits geladenen Tabelle eingelesen werden. Er dient dazu, die Datensätze der im resident-Zusatz bezeichneten Tabelle vor dem erneuten Einlesen zu sortieren. Dabei kann nach einem oder mehreren Felder in auf- oder absteigender Reihenfolge sortiert werden. Die Sortierung erfolgt zunächst nach numerischen Werten, dann nach nationaler Sortierreihenfolge. Diese Bedingung darf nur verwendet werden, wenn die Datenquelle eine bezeichnete Tabelle ist. Mit den Ordnungsfeldern wird angegeben, nach welchem Feld die bezeichnete Tabelle sortiert wird. Das Feld kann durch den Feldnamen oder die Feldnummer bezeichnet sein (die Nummerierung beginnt stets bei 1). orderbyfieldlist ::= fieldname [ sortorder ] { , fieldname [ sortorder ] } Hinter sortorder folgt entweder asc für aufsteigend oder desc für absteigend. Fehlt die sortorder, wird asc angenommen. fieldname, path, filename und aliasname sind Strings. Als fieldname kann jedes Feld in der Quelltabelle verwendet werden. Felder, die mithilfe der as-Bedingung (aliasname) erstellt werden, befinden sich außerhalb des Gültigkeitsbereichs und können nicht im gleichen load-Befehl verwendet werden.

Wenn durch keinen der Zusätze from, inline, resident from_field oder autogenerate eine Datenquelle definiert wird, werden Daten aus dem Ergebnis des direkt nachfolgenden SELECT- oder LOAD-Befehls geladen. Diesem nachfolgenden Befehl sollte kein Zusatz vorangehen.

Laden von Daten aus bereits geladenen Tabellen

Bei der Dateierweiterung von DataFiles-Verbindungen wird zwischen Groß- und Kleinschreibung unterschieden. Beispiel: .qvd.

Beispiele:

Laden von nur drei spezifischen Feldern aus einer Datei mit Trennzeichen:

LOAD FirstName, LastName, Number from [lib://DataFiles/data1.csv];

Erstes Feld zu A umbenennen und zweites Feld zu B umbenennen beim Laden einer Datei ohne Bezeichnungen:

LOAD @1 as A, @2 as B from [lib://DataFiles/data3.txt] (ansi, txt, delimiter is '\t', no labels);

Laden von Name als Zusammenfassung von FirstName, einem Leerzeichen und LastName:

LOAD FirstName&' '&LastName as Name from [lib://DataFiles/data1.csv];

Laden von Quantity, Price und Value (das Produkt aus Quantity und Price):

LOAD Quantity, Price, Quantity*Price as Value from [lib://DataFiles/data1.csv];

Nur einzigartige Datensätze laden, doppelte Datensätze werden ausgeschlossen:

LOAD distinct FirstName, LastName, Number from [lib://DataFiles/data1.csv];

Nur Datensätze laden, bei denen das Feld Litres einen Wert über Null hat:

LOAD * from [lib://DataFiles/Consumption.csv] where Litres>0;

Laden einer Tabelle mit Inline-Daten, zwei Feldern mit den Namen CatID und Category:

LOAD * Inline

[CatID, Category

0,Regular

1,Occasional

2,Permanent];

Laden einer Tabelle mit Inline-Daten, drei Feldern mit den Namen UserID, Password und Access:

LOAD * Inline [UserID, Password, Access

A, ABC456, User

B, VIP789, Admin];

Laden einer Tabelle mit 10 000 Zeilen. Feld A enthält die Zahl des Datensatzes (1,2,3,4,5...) und Feld B enthält eine zufällige Zahl zwischen 0 und 1:

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

Die Klammer nach autogenerate ist zulässig, aber nicht erforderlich.

Zunächst laden wir eine Tabellendatei mit Trennzeichen und benennen sie tab1:

tab1:

SELECT A,B,C,D from [lib://DataFiles/data1.csv];

Laden von Feldern aus der bereits geladenen tab1-Tabelle als tab2:

tab2:

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

Laden von Feldern aus der bereits geladenen Tabelle tab1, aber nur Datensätze bei denen A größer als B ist:

tab3:

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

Laden von Feldern aus der bereits geladenen Tabelle tab1 sortiert nach A:

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

Laden von Feldern aus der bereits geladenen Tabelle tab1, sortiert nach dem ersten Feld und dann nach dem zweiten Feld:

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

Laden von Feldern aus der bereits geladenen Tabelle tab1 absteigend sortiert nach C, dann aufsteigend nach B und dann nach dem ersten Feld in absteigender Reihenfolge:

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

Laden des Feldes Types aus der bereits geladenen Tabelle Characters als A:

LOAD A from_field (Characters, Types);

Laden von A, B und berechneten Feldern X und Y aus Table1, die in dem folgenden SELECT-Befehl geladen wird:

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

SELECT A,B,C,D from Table1;

Laden von Feldern gruppiert (aggregiert) nach ArtNo:

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

Laden von Feldern gruppiert (aggregiert) nach Week und ArtNo:

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

In diesem Beispiel gibt es eine Inputdatei Grades.csv, welche die Noten aller Schüler zusammengefasst in einem Feld enthält:

Student,Grades

Mike,5234

John,3345

Pete,1234

Paul,3352

Die Noten zwischen 1 und 5 stehen für die Fächer Math, English, Science und History. Wir können die Noten in separate Werte aufteilen, indem wir jeden Datensatz mehrmals mit einer while-Bedingung einlesen, wobei die IterNo( )-Funktion als Zähler dient. Bei jedem Lesevorgang wird die Note mit der Mid-Funktion extrahiert und in der Grade gespeichert und das Fach wird mit der pick-Funktion ausgewählt und im Subject gespeichert. Die letzte while-Bedingung enthält den Test zur Überprüfung, ob alle Noten eingelesen wurden (in diesem Fall vier pro Schüler), was bedeutet, dass der nächste Schülerdatensatz gelesen werden sollte.

MyTab:

LOAD Student,

mid(Grades,IterNo( ),1) as Grade,

pick(IterNo( ), 'Math', 'English', 'Science', 'History') as Subject from [lib://DataFiles/Grades.csv]

while IsNum(mid(Grades,IterNo(),1));

Das Ergebnis ist eine Tabelle mit folgenden Daten:

Resulting data table

Die folgenden Beispieldaten werden verwendet.

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

Laden von Daten mithilfe einer Funktion

In diesem Beispiel wird davon ausgegangen, dass ein Analyseverbindungs-Plugin mit dem Namen P vorhanden ist, das eine benutzerdefinierte Funktion Calculate(Parameter1, Parameter2) enthält. Die Funktion gibt die Tabelle Results zurück, die die Felder Field1 und Field2 enthält.

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

Alle Felder laden, die zurückgegeben werden, wenn die Felder A und C an die Funktion gesendet werden.

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

Nur das Feld Field1 laden, wenn die Felder A und C an die Funktion gesendet werden.

Load * Extension P.Calculate( Values );

Alle Felder laden, die zurückgegeben werden, wenn die Felder A und B an die Funktion gesendet werden. Da keine Felder angegeben sind, werden A und B in der Reihenfolge ihres Vorkommens in der Tabelle verwendet.

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

Alle Felder laden, die zurückgegeben werden, wenn Feld C an beide Parameter der Funktion gesendet werden.

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

Alle Felder laden, die zurückgegeben werden, wenn Feld A als String erzwungen und Feld B als numerisch erzwungen an die Funktion gesendet werden.

Laden von Daten durch Auswertung eines Skripts

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

Die Tabelle laden, die von Skript q zurückgegeben wird, wenn die Werte von A und B gesendet werden.

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

Die Tabelle laden, die von dem in der Variablen My_R_Script gespeicherten Skript zurückgegeben wird, wenn die Werte von A und B gesendet werden.

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

Die Tabelle laden, die von dem in der Variablen My_R_Script gespeicherten Skript zurückgegeben wird, wenn die Werte von B umbenannt in D, A und C gesendet werden. Durch Verwenden von * werden die restlichen nicht referenzierten Felder gesendet.

Hat diese Seite Ihnen geholfen?

Wenn Sie Probleme mit dieser Seite oder ihren Inhalten feststellen – einen Tippfehler, einen fehlenden Schritt oder einen technischen Fehler –, teilen Sie uns bitte mit, wie wir uns verbessern können!

Geben Sie hier Ihr Feedback ab