Load

LOAD-satsen laddar fält från en fil, direkt från data i skriptet, från en tidigare inläst tabell, från en webbsida, från resultatet av en efterföljande SELECT-sats eller genom att generera data automatiskt. Det går även att ladda data från analyskopplingar.

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 ]

Argument
Argument	Beskrivning
distinct	Du kan använda distinct som predikat om du bara vill ladda unika poster. Om det finns dubblettposter laddas den första. Om du använder föregående load måste du placera distinct i den första load-satsen, eftersom distinct bara inverkar på destinationstabellen. Föregående Load
fieldlist	fieldlist ::= ( * \| field{, * \| field } ) En lista på de fält som ska läsas in. Genom att använda * som fältlista anger man alla fält i tabellen. field ::= ( fieldref \| expression ) [as aliasname ] Fältdefinitionen måste alltid innehålla en litteral, en referens till ett befintligt fält eller ett uttryck. fieldref ::= ( fieldname \|@fieldnumber \|@startpos:endpos [ I \| U \| R \| B \| T] ) fieldname är en text som är identisk med fältnamnet i tabellen. Observera att fältnamnet måste omslutas av raka, dubbla citationstecken eller av hakparenteser om det innehåller exempelvis mellanslag. Ibland är fältnamn inte explicit tillgängliga. Då används en annan metod: @fieldnumber representerar fältnumret i en avgränsad tabellfil. Det måste vara ett positivt heltal som föregås av "@". Numreringen går alltid från 1 och upp till antalet fält. @startpos:endpos representerar första och sista teckenposition för fältet i en fixpostfil med fasta fältpositioner. Positionerna måste vara positiva heltal. De två talen måste föregås av "@" och avgränsas av kolon. Numreringen går alltid från 1 och upp till antalet positioner. I det sista fältet används n som slutposition. Om@startpos:endpos omedelbart följs av tecknen I ellerU, tolkas inlästa bytes som binärt signerade (I) eller osignerade (U) heltal (Intel byte order). Antalet positioner som läses måste vara 1, 2 eller 4. Om @startpos:endpos omedelbart följs av tecknet R, tolkas inlästa bytes som ett binärt reellt tal (IEEE 32-bitars eller 64-bitars floating point). Antalet positioner som läses in måste vara 4 eller 8. Om @startpos:endpos omedelbart följs av tecknet B, tolkas inlästa bytes som BCD (Binary Coded Decimal)-tal enligt COMP-3-standard. Valfritt antal bytes kan anges. expression kan vara en numerisk funktion eller en strängfunktion baserad på ett eller flera andra fält i samma tabell. För ytterligare information, se uttryckens syntax. as används för att döpa om fält.
from	from används om data ska läsas in från en fil med en mapp. Vid inläsning från en fil i ett utrymme i Qlik Cloud-analys måste en giltig sökväg användas. Se Regler för giltiga mappsökvägar i utrymmet. file ::= [ path ] filename I Qlik Cloud-analys stöds hierarkiska mappstrukturer och de kan refereras till i uttalandet. Exempel: Personligt utrymme (överst sökväg): [lib://DataFiles/abc.qvd] Personligt utrymme (nästlad mapp): [lib://DataFiles/MyFolder/abc.qvd] Delat utrymme (överst sökväg): [lib://TeamSharedSpace:DataFiles/xyz.qvd] Delat utrymme (nästlad mapp): [lib://TeamSharedSpace:DataFiles/MyFolder/abc.qvd] Se Läser in filer från utrymmen i Qlik Cloud-analys för mer information och exempel.
from_field	from_field används om data ska läsas in från ett tidigare inläst fält. fieldassource::=(tablename, fieldname) Fältet är namnet på tidigare inlästa tablename och fieldname. format-spec ::= ( fspec-item {, fspec-item } ) Formatspecifikationen består av en lista med flera formatspecifikatorer inom parentes. Mer information finns i Formatspecifikatorer. Anteckning om informationfrom_field har bara stöd för komman som listavgränsare vid separering av fält i tabeller.
inline	inline används om data ska skrivas i skriptet, och inte läsas in från en fil. data ::= [ text ] Data som läses in med en inline-sats måste inledas och avslutas med specifika tecken – hakparenteser, citationstecken eller backticks. Texten mellan dessa tolkas som om den vore skriven i en fil. Precis som du infogar en ny rad i en textfil bör du göra det även i texten i en inline-sats. Klicka på vanligt sätt på returtangenten när du skriver skriptet. I en enkel inline-laddning definieras antalet kolumner av den första raden. format-spec ::= ( fspec-item {, fspec-item } ) Du kan anpassa inline-laddningen med många av samma formatspecifikationselement som kan användas för andra laddade tabeller. De här elementen listas inom parentes. Mer information finns i Formatspecifikatorer. Mer information om hur du använder inline-laddningar finns i Använda inline-laddningar för att ladda data.
resident	resident används om data ska läsas in från en tidigare inläst tabell. table label är en etikett som föregår de LOAD- eller SELECT-satser som skapade den ursprungliga tabellen. Etiketten ska avslutas med kolon. Läsa in data från en tidigare inläst tabell Tabelletiketter
autogenerate	autogenerate används när data ska genereras automatiskt av Qlik Sense. size ::= number Number är ett heltal som anger antalet poster som ska genereras. Fältlistan får inte innehålla uttryck som behöver data från en extern datakälla eller från en tidigare laddad tabell, om du inte hänvisar till ett enda fältvärde i en tidigare laddad tabell med hjälp av Peek-funktionen.
where	where är ett tillägg som används för att tala om huruvida en post ska inkluderas i valet eller inte. Valet inkluderas om criterion är True. criterion är ett logiskt uttryck.
while	while är en sats som används för att tala om när en post ska läsas in upprepade gånger. Samma post läses in så länge criterion är True. För att vara användbar måste en while-sats typiskt sett innehålla en IterNo( )-funktion. criterion är ett logiskt uttryck.
group by	group by används för att definiera över vilka fält data ska aggregeras (grupperas). Aggregeringsfälten ska på något sätt inlemmas i de uttryck som läses in. Inga andra fält än aggregeringsfälten får användas utanför aggregeringsfunktionerna i inläsningsuttrycken. groupbyfieldlist ::= (fieldname { ,fieldname } )
order by	order by är en sats som används för att sortera poster i en resident tabell innan de bearbetas av load-satsen. Den residenta tabellen kan sorteras efter ett eller flera fält, i stigande eller sjunkande ordning. Sortering görs i första hand efter talvärde, i andra hand efter nationell sorteringsspråkvariant. Satsen är endast användbar när datakällan är en resident tabell. Ordningsföljdsfälten anger efter vilket fält resident-tabellen sorteras. Ange fältets namn eller dess nummer i resident-tabellen (det första fältet får nummer 1). orderbyfieldlist ::= fieldname [ sortorder ] { , fieldname [ sortorder ] } sortorder är antingen asc för stigande eller desc för fallande. Om ingen sortorder anges, antas asc. fieldname, path, filename och aliasname är textsträngar som representerar det namnen antyder. Valfritt fält i källtabellen kan användas som fieldname. Däremot hamnar fält som har skapats med hjälp av as-satsen (aliasname) utanför och kan inte användas inuti samma load-sats.

Om ingen datakälla anges genom en from, inline, resident, from_field, komplement eller autogenerate-sats kommer data att läsas in från resultatet av närmast efterföljande SELECT- eller LOAD-sats. Den efterföljande satsen får inte ha något prefix.

Läsa in data från en tidigare inläst tabell

Filtillägget för DataFiles-kopplingar är skiftlägeskänsligt. Till exempel: .qvd.

Exempel:

Ladda endast tre specifika fält från en avgränsad fil:

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

Döp om fet första fältet som A och det andra fältet som B när du laddar en fil utan etiketter:

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

Ladda Name som en konkatenering av FirstName, ett blanksteg och LastName:

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

Ladda Quantity, Price och Value (produkten av Quantity och Price):

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

Ladda endast unika poster, dubblettposter kommer att uteslutas:

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

Ladda endast poster där fältet Litres har ett värde över noll:

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

Ladda en tabell med inline-data, två fält som kallas CatID och Category:

LOAD * Inline

[CatID, Category

0,Regular

1,Occasional

2,Permanent];

Ladda en tabell med inline-data, tre fält som kallas UserID, Password och Access:

LOAD * Inline [UserID, Password, Access

A, ABC456, User

B, VIP789, Admin];

Ladda en tabell med 10 000 rader. Fält A kommer innehålla talet för posten som ska laddas (1,2,3,4,5...) och fältet B innehåller ett slumpmässigt nummer mellan 0 och 1:

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

Parentesen efter autogenerate är tillåten men inte obligatorisk.

Först laddar vi en avgränsad tabellfil och kallar dentab1:

tab1:

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

Ladda fält från den redan laddade tabellen tab1 som tab2:

tab2:

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

Ladda fält från den redan laddade tabellen tab1 men bara poster där A är större än B:

tab3:

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

Ladda fält som den redan laddade tabellentab1 ordnade efter A:

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

Ladda fält från den redan laddade tabellen tab1, ordnade efter det första fältet, sedan efter det andra fältet:

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

Ladda fält från den redan laddade tabellentab1 ordnade efter C i fallande ordning, sedan efter B i stigande ordning och därefter efter det första fältet i fallande ordning:

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

Ladda fältet Types från den tidigare laddade tabellen Characters som A:

LOAD A from_field (Characters, Types);

Ladda A, B och de beräknade fälten X och Y från Table1 som laddas i efterföljande SELECT-sats:

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

SELECT A,B,C,D from Table1;

Ladda fält grupperade (aggregerade) efter ArtNo:

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

Ladda fält grupperade (aggregerade) efter Week och ArtNo:

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

I detta exempel har vi indatafilen Grades.csv som innehåller betygen för varje student, kondenserat till ett fält:

Student,Grades

Mike,5234

John,3345

Pete,1234

Paul,3352

Betygen, i en skala från 1 till 5, motsvarar Math, English, Science ochHistory. Vi kan dela upp betygen i separata värden genom att läsa in varje post flera gånger med en while-sats och använda IterNo( )-funktionen som räknare. Vid varje inläsning extraheras betyget med funktionen Mid och lagras i Grade och ämnet väljs med hjälp av funktionen pick och lagras i Subject. Den slutliga while-satsen innehåller testet för att kontrollera om alla betyg har lästs (fyra per student i det här fallet), vilket innebär att nästa studentpost ska läsas.

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

Resultatet blir en tabell med dessa data:

Resulting data table

Följande exempeldata används.

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

Ladda data med en funktion

I dessa exempel antar vi att vi har ett insticksprogram med analytisk koppling som heter P som innehåller den anpassade funktionen Calculate(Parameter1, Parameter2). Funktionen returnerar tabellen Results som innehåller fälten Field1 ochField2.

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

Ladda alla fält som returneras när fälten A och C skickas till funktionen.

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

Ladda bara Field1-fältet när fälten A och C skickas till funktionen.

Load * Extension P.Calculate( Values );

Ladda alla fält som returneras när fälten A och B skickas till funktionen. Eftersom fält inte är angivna används A och B eftersom de står först i tabellordningen.

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

Ladda alla fält som returneras när fältet C skickas till funktionens båda parametrar.

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

Ladda alla fält som returneras när fält A skickas tvingad till sträng och fält B skickas tvingad till numerisk till funktionen.

Ladda data genom att utvärdera ett skript

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

Ladda tabellen som returneras av q-skriptet när värdena av A och B skickas.

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

Ladda tabellen som returneras av skriptet som lagras i My_R_Script-variabeln när värdena av A och B skickas.

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

Ladda tabellen som returneras av skriptet som lagras i My_R_Script-variabeln när värdena av B som döpts om till D, A och C skickas. Använd * för att skicka återstående orefererade fält.

Läser in filer från utrymmen i Qlik Cloud-analys

I Qlik Cloud-analys kan du använda en LOAD-sats eller infoga QVS-kod när du laddar data från en datafil i ett laddningsskript. I båda fallen kan hierarkiska mappstrukturer för utrymmen refereras i skriptsatsen. Följ reglerna för giltiga mappsökvägar i utrymmet. Filen och alla refererade mappar måste redan finnas på den angivna platsen. I annat fall misslyckas inläsningen.

Exempel: Referenser till fil i översta sökvägen i ett utrymme

I det här exemplet laddas filen orders.csv från ett personligt utrymme. Filen är inte placerad i någon specifik mapp, utan finns i stället i den översta sökvägen i utrymmet.

LOAD * FROM [lib://DataFiles/orders.csv];

I detta exempel laddas filen orders.csv från ett delat, hanterat eller datautrymme. Namnet på utrymmet är TeamSharedSpace. Filen är inte placerad i någon specifik mapp, utan finns i stället i den översta sökvägen i utrymmet.

LOAD * FROM [lib://TeamSharedSpace:DataFiles/orders.csv];

Exempel: Referenser till en specifik mappsökväg inom ett utrymme

I det här exemplet laddas filen orders_Europe.csv från mappen Orders By Region i ett personligt utrymme.

LOAD * FROM [lib://DataFiles/Orders By Region/orders_Europe.csv];

I det här exemplet laddas filen orders_Europe.csv från mappen Orders By Region i ett delat, hanterat eller datautrymme. Namnet på utrymmet är SalesSpace.

LOAD * FROM [lib://SalesSpace:DataFiles/Orders By Region/orders_Europe.csv];

Se Referera till utrymmets mappstruktur vid utveckling av appar och skript för mer information om hänvisning till mappstrukturen i utrymmen i laddskript.

Var den här sidan till hjälp för dig?

Om du hittar några fel på denna sida eller i innehållet – ett stavfel, ett steg som saknas eller ett tekniskt fel – berätta för oss så att vi kan blir bättre!

Lämna din feedback här