Load

Met de opdracht LOAD worden velden geladen uit een bestand, uit gegevens die in het script zijn gedefinieerd, uit een eerder geladen tabel, van een webpagina, uit het resultaat van een daaropvolgende SELECT-opdracht of door gegevens automatisch te genereren.

Syntaxis:

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 ]

Argumenten:

Argumenten voor load
Argument	Beschrijving
distinct	U kunt distinct als predicaat gebruiken wanneer u alleen unieke records wilt laden. Als er dubbele records zijn, wordt het eerste exemplaar geladen. Als u voorgaande loads gebruikt, moet u distinct in de eerste laadinstructie plaatsen, aangezien distinct alleen van invloed is op de bestemmingstabel.
fieldlist	fieldlist ::= ( * \| field {, field } ) Een lijst van de velden die geladen moeten worden. Gebruik een * als veldlijst om alle velden in de tabel aan te duiden. field ::= ( fieldref \| expression ) [as aliasname ] De velddefinitie moet altijd een literal, een referentie naar een bestaand veld of een uitdrukking bevatten. fieldref ::= ( fieldname \|@fieldnumber \|@startpos:endpos [ I \| U \| R \| B \| T] ) fieldname is een tekst die identiek is aan een veldnaam in de tabel. Houd er rekening mee dat de veldnaam tussen rechte dubbele aanhalingstekens of vierkante haken moet staan als deze bijvoorbeeld spaties bevat. Soms zijn veldnamen niet expliciet beschikbaar. In dat geval wordt een andere notatie gebruikt: @fieldnumber geeft het veldnummer in een tabelbestand met scheidingstekens aan. Het moet een positief geheel getal zijn, voorafgegaan door "@". De nummering is altijd vanaf 1 optellend tot het aantal velden. @startpos:endpos geeft de begin- en eindposities van een veld aan in een bestand met een vaste recordlengte. De posities moeten beide positieve gehele getallen zijn. De twee getallen moeten worden voorafgegaan door "@" en gescheiden door een dubbele punt. De nummering is altijd vanaf 1 optellend tot het aantal posities. In het laatste veld wordt n gebruikt als eindpositie. Als @startpos:endpos direct wordt gevolgd door de tekens I ofU, worden de gelezen bytes geïnterpreteerd als een binair ondertekend (I) of niet-ondertekend (U) geheel getal (Intel-bytevolgorde). Het aantal gelezen posities moet 1, 2 of 4 zijn. Als @startpos:endpos direct wordt gevolgd door het teken R, worden de bytes geïnterpreteerd als een binair reëel getal (IEEE 32-bits of 64-bits drijvende komma). Het aantal gelezen posities moet 4 of 8 zijn. Als @startpos:endpos direct wordt gevolgd door het teken B, worden de gelezen bytes geïnterpreteerd als een BCD (Binary Coded Decimal) volgens de COMP-3-standaard. U kunt een willekeurig aantal bytes opgeven. expression kan een numerieke functie of een tekenreeksfunctie zijn, gebaseerd op een of meer andere velden in dezelfde tabel. Zie de syntaxis van uitdrukkingen voor meer informatie. as wordt gebruikt om een nieuwe naam aan een veld toe te wijzen.
from	from wordt gebruikt als gegevens uit een bestand moeten worden geladen. file ::= [ path ] filename absoluut Voorbeeld: c:\data\ relatief ten opzichte van het documentpad van QlikView. Voorbeeld: data\ URL-adres (HTTP of FTP) dat verwijst naar een locatie op internet of intranet. De URL moet URL-gecodeerd zijn, bijvoorbeeld als deze spaties bevat. Voorbeeld: http://www.qlik.com Voorbeeld: http://www.enterprise.com/project%20files (http://www.enterprise.com/project files) Als er geen pad is opgegeven, zoekt QlikView het bestand in de map die is opgegeven in de instructie Directory. Als er geen Directory-instructie is, zoekt QlikView in de werkmap, meestal de map waarin het QlikView-bestand zich bevindt. InformatieIn een QlikView-serverinstallatie is C:\ProgramData\QlikTech\Documents de standaardwerkmap. De standaardwerkmap kan worden gewijzigd in de QlikView Beheerconsole. De filename kan de standaard DOS-jokertekens ( * en ? ) bevatten. Daarmee worden alle overeenkomstige bestanden in de opgegeven map geladen. format-spec ::= ( fspec-item { , fspec-item } ) De opmaakspecificatie bestaat uit een lijst met verschillende opmaakspecificatie-items, tussen haakjes. Directory From
from_field	from_field wordt gebruikt als gegevens moeten worden geladen uit een eerder geladen veld. fieldassource::=(tablename, fieldname) De veldnaam is de naam van de eerder geladen tablename en fieldname. format-spec ::= ( fspec-item {, fspec-item } ) De opmaakspecificatie bestaat uit een lijst met verschillende opmaakspecificaties, tussen haakjes.
inline	inline wordt gebruikt als gegevens moeten worden getypt in het script en niet uit een bestand moeten worden geladen. data ::= [ text ] Gegevens die u invoert met een inline-clausule moeten tussen dubbele aanhalingstekens of tussen vierkante haakjes worden geplaatst. De tekst ertussen wordt net zo geïnterpreteerd als de inhoud van een bestand. Waar u in een tekstbestand bijvoorbeeld een nieuwe regel zou invoegen, moet u dat ook doen in de tekst van een inline-clausule. U drukt dus op Enter bij het typen van het script. Het aantal kolommen wordt bepaald door de eerste regel. format-spec ::= ( fspec-item {, fspec-item } ) De opmaakspecificatie bestaat uit een lijst met verschillende opmaakspecificaties, tussen haakjes.
resident	resident wordt gebruikt als gegevens moeten worden geladen uit een eerder geladen tabel. table label is een label dat vooraf gaat aan de LOAD- of SELECT-opdracht(en) waarmee de oorspronkelijke tabel is gemaakt. Het label moet worden opgegeven met een puntkomma aan het eind. Wanneer een combinatie van de laadinstructies distinct en resident wordt gebruikt in QlikView 12.00 of latere versies, is de volgorde van geladen gegevens anders dan in QlikView 11.20. Voeg een order by-clausule toe om een gewenste laadvolgorde te definiëren. Gegevens laden uit een eerder geladen tabel Tabellabels
autogenerate	autogenerate wordt gebruikt als gegevens automatisch moeten worden gegenereerd door QlikView. size ::= number Number is een geheel getal dat het aantal te genereren records aangeeft. De veldlijst mag geen uitdrukkingen bevatten waarvoor gegevens uit een database nodig zijn. Alleen constanten en functies zonder parameters (zoals rand() of recno()) zijn in de uitdrukkingen toegestaan.
extension	U kunt gegevens via analytische verbindingen laden. Als u een functie wilt aanroepen die in de SSE-plug-in is gedefinieerd, moet u de clausule extension gebruiken of een script evalueren. U kunt één tabel naar de SSE-plugin verzenden, waarop één gegevenstabel wordt teruggegeven. Als door de plugin niet de namen worden aangegeven van de velden die worden teruggegeven, krijgen de velden de namen Field1, Field2 enzovoort. Extension pluginname.functionname( tabledescription ); Gegevens laden met een functie in een SSE-plug-in tabledescription ::= (table { ,tablefield} ) Als u geen tabelvelden aangeeft, worden de velden gebruikt in de volgorde waarin deze zijn ingeladen. Gegevens laden door een script in een SSE-plug-in te evalueren tabledescription ::= ( script, table { ,tablefield} ) Afhandeling van gegevenssoorten in de tabelvelddefinitie Gegevenssoorten in analytische verbindingen worden automatisch gedetecteerd. Als de gegevens geen getalswaarden bevatten en ten minste één teksttekenreeks die niet leeg is, wordt het veld als tekstveld beschouwd. In alle andere gevallen wordt het veld als getalsveld beschouwd. U kunt de gegevenssoort afdwingen door een veldnaam op te nemen met String() of Mixed(). Met String() maakt u het veld een tekstveld. Als het veld numeriek is, wordt het tekstgedeelte van de dubbele waarde geëxtraheerd. Er wordt niet geconverteerd. Met Mixed() maakt u het veld een veld met dubbele waarden. String() en Mixed() kunnen niet buiten tabelvelddefinities van extension worden gebruikt, en u kunt geen andere QlikView-functies in een tabelvelddefinitie gebruiken. Meer over analytische verbindingen Voor het maken van analytische verbindingen in QlikView Server of QlikView Desktop, zie: Analytische verbindingen Meer over analytische verbindingen leest u in GitHub. qlik-oss/server-side-extension
where	where is een clausule die wordt gebruikt om aan te geven of een record wel of niet in de selectie moet worden opgenomen. De selectie wordt opgenomen als criterion de waarde True heeft. criterion is een logische uitdrukking.
while	while is een clausule die aangeeft of een record herhaaldelijk moet worden gelezen. Hetzelfde record wordt gelezen zolang criterion de waarde True heeft. Een while-clausule is vaak pas nuttig wanneer u deze samen met de functie IterNo( ) gebruikt. criterion is een logische uitdrukking.
group_by	group by is een clausule die wordt gebruikt om te definiëren over welke velden de gegevens moeten worden geaggregeerd (gegroepeerd). De aggregatievelden moeten op de een of andere manier in de geladen uitdrukkingen worden opgenomen. U mag geen andere velden dan de aggregatievelden gebruiken buiten aggregatiefuncties in de geladen uitdrukkingen. groupbyfieldlist ::= (fieldname { ,fieldname } )
order_by	order by is een clausule die wordt gebruikt om de records van een residente tabel te sorteren voordat ze worden verwerkt door de load-opdracht. De residente tabel kan worden gesorteerd op één of meer velden in oplopende of aflopende volgorde. Het sorteren gebeurt primair op numerieke waarde en secundair op nationale sorteervolgorde. U kunt deze clausule alleen gebruiken wanneer de gegevensbron een residente tabel is. De volgordevelden geven aan op welk veld de residente tabel wordt gesorteerd. U kunt het veld opgeven met z'n naam of met z'n nummer in de residente tabel (het eerste veld is nummer 1). orderbyfieldlist ::= fieldname [ sortorder ] { , fieldname [ sortorder ] } sortorder is asc voor oplopend of desc voor aflopend. Als u geen sortorder opgeeft, wordt asc verondersteld. fieldname, path, filename en aliasname zijn tekenreeksen die aangeven waar de respectievelijke namen voor staan. Elk veld in de brontabel kan worden gebruikt als fieldname. Velden die zijn gemaakt via de as-clausule (aliasname) vallen echter buiten het bereik en kunnen niet worden gebruikt binnen dezelfde load-instructie.

Als u geen gegevensbron opgeeft door middel van de clausule from, inline, resident, from_field of autogenerate, worden gegevens geladen uit de resultaten van de direct volgende SELECT- of LOAD-instructie. Deze instructie geen prefix hebben.

Voorafgaande LOAD

Voorbeelden:

Laad een bestand met gegevens met scheidingstekens met standaardopties:

LOAD * from data1.csv;

Laad een bestand met gegevens met scheidingstekens, waarbij een komma is opgegeven als scheidingsteken en ingesloten labels worden gebruikt:

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

Laad een bestand met gegevens met scheidingstekens, waarbij een tab is opgegeven als scheidingsteken en ingesloten labels worden gebruikt:

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

Laad een dif-bestand met ingesloten kopteksten:

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

Laad drie velden vanuit een bestand met vaste recordlengte zonder kopteksten:

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

Laad een QVX-bestand, waarbij een absoluut pad wordt opgegeven:

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

Laad slechts drie specifieke velden vanuit een bestand met gegevens met scheidingstekens:

LOAD FirstName, LastName, Number from data1.csv;

Hernoem het eerste veld tot A en het tweede veld tot B bij het laden van een bestand zonder labels:

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

Laad Name als een samenvoeging van FirstName, een spatie en LastName:

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

Laad Quantity, Price en Value (het product van Quantity en Price):

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

Laad alleen unieke records. Dubbele records worden verwijderd:

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

Laad alleen records waarbij het veld Litres een waarde van meer dan nul heeft:

LOAD * from Consumption.csv where Litres>0;

Laad een tabel met uitgelijnde gegevens en twee velden met de naam CatID en Category:

LOAD * Inline

[CatID, Category

0,Regular

1,Occasional

2,Permanent];

Laad een tabel met uitgelijnde gegevens en drie velden met de naam UserID, Password en Access:

LOAD * Inline [UserID, Password, Access

A, ABC456, User

B, VIP789, Admin];

Laad een tabel met 10.000 rijen. Veld A bevat het nummer van de ingelezen record (1,2,3,4,5...) en veld B bevat een willekeurig getal tussen 0 en 1:

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

De haakjes na autogenerate zijn toegestaan maar niet verplicht.

Als eerste laden we een bestand met een tabel met scheidingstekens en geven dat de naam tab1:

tab1:

SELECT A,B,C,D from transtable;

Laad velden vanuit de reeds geladen tabel tab1 als tab2:

tab2:

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

Laad velden uit reeds geladen tabel tab1 maar alleen records waarbij A groter is dan B:

tab3:

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

Laad velden uit al geladen tabel tab1 geordend volgens A:

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

Laad velden vanuit reeds geladen tabel tab1, geordend volgens het eerste veld en vervolgens het tweede veld:

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

Laad veld vanuit reeds geladen tabel tab1 geordend volgens C aflopend, daarna B in oplopende volgorde, en dan het eerste veld in aflopende volgorde:

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

Laad veld Types uit eerder geladen tabel Characters als A:

LOAD A from_field (Characters, Types);

Laad A, B en berekende velden X en Y vanuit Table1 die is geladen in de volgende SELECT-opdracht:

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

SELECT A,B,C,D from Table1;

Voorafgaande LOAD

Laad velden gegroepeerd (geaggregeerd) op ArtNo:

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

Laad velden gegroepeerd (geaggregeerd) opWeek en ArtNo:

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

In dit voorbeeld hebben we een invoerbestand, Grades.csv, met de cijfers voor elke student gecomprimeerd in één veld:

Student,Grades

Mike,5234

John,3345

Pete,1234

Paul,3352

De cijfers, op een schaal van 1-5, staan voor Math, English, Science en History. We kunnen de cijfers scheiden tot afzonderlijke waarden. Hiervoor lezen we elke record meerdere keren met een while-clausule. We gebruiken de functieIterNo( ) als een teller. Bij elke lezing wordt het cijfer uit de functie Mid gehaald en opgeslagen in Grade en wordt het vak geselecteerd op basis van de functie pick en opgeslagen in Subject. De laatste while-clausule bevat de test waarmee wordt gecontroleerd of alle cijfers zijn gelezen (in dit geval vier per leerling). Dat houdt in dat de volgende leerlingrecord moet worden gelezen.

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

Het resultaat is een tabel met de volgende gegevens:

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

De onderstaande voorbeeldgegevens worden gebruikt.

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

Gegevens inladen met een functie

In deze voorbeelden nemen we aan dat we een plugin met de naam P voor analytische verbinding hebben, die een aangepaste functie Calculate(Parameter1, Parameter2) bevat. Deze functie geeft de tabel Results terug met de velden Field1 en Field2.

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

Hiermee laadt u alle gegevens in die worden teruggegeven nadat de velden A en C naar de functie zijn verzonden.

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

Hiermee laadt u alleen veld Field1 in de velden A en C naar de functie zijn verzonden.

Load * Extension P.Calculate( Values );

Hiermee laadt u alle gegevens in die worden teruggegeven nadat de velden A en B naar de functie zijn verzonden. Als velden niet gespecificeerd zijn, worden A en B gebruikt als deze het eerst zijn in de volgorde in de tabel.

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

Hiermee laadt u alle velden in die worden teruggegeven nadat het veld C naar beide parameters van de functie is verzonden.

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

Hiermee laadt u alle velden in die worden teruggegeven nadat het veld A geforceerd als tekenreeks en het veld B geforceerd als numeriek naar de functie zijn verzonden.

Gegevens inladen door een script te evalueren

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

Laad de tabel die door het script q wordt teruggegeven als de waarden van A en B worden verzonden.

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

Hiermee laadt u de tabel in die door het script wordt teruggegeven in de variabele My_R_Script als de waarden A en B worden verzonden.

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

Hiermee laadt u de tabel in die door het script wordt teruggegeven in de variabele My_R_Script als de waarden van B worden herbenoemd tot D, A en C. Als u * gebruikt, verzendt u de overgebleven ongekoppelde velden.

Meer informatie

Opmaakspecificaties

Was deze pagina nuttig?

Als u problemen ervaart op deze pagina of de inhoud onjuist is – een typfout, een ontbrekende stap of een technische fout – laat het ons weten zodat we dit kunnen verbeteren!

Geef hier uw feedback

Load

Meer informatie

Was deze pagina nuttig?

Neem deel aan het Analytics Modernization Program