Load

LOAD deyimi, alanları bir dosyadan, kod içinde tanımlanmış verilerden, daha önceden yüklenmiş tablodan, web sayfasından, ardından gelen SELECT deyiminin sonucundan veya verileri otomatik olarak oluşturarak yükler.Analiz bağlantılarından da veriler yüklenebilir.

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 ]

Arguments:

Bağımsız Değişkenler
Bağımsız Değişken	Açıklama
distinct	Yalnızca benzersiz kayıtları yüklemek istiyorsanız koşul olarak distinct öğesini kullanabilirsiniz. Çoğaltılmış kayıtlar varsa birinci örnek yüklenir. Önceki yüklemeleri kullanıyorsanız distinct yalnızca hedef tabloyu etkilediğinden birinci load deyimine distinct öğesini yerleştirmeniz gerekir. Öncelikli yükleme
fieldlist	fieldlist ::= ( * \| field {, * \| field } ) Yüklenecek alanların listesi. Alan listesi olarak * kullanılması tablodaki tüm alanları işaret eder. field ::= ( fieldref \| expression ) [as aliasname ] Alan tanımı, her zaman için bir değişmez değeri, mevcut alana bir referansı veya bir ifadeyi içermelidir. fieldref ::= ( fieldname \|@fieldnumber \|@startpos:endpos [ I \| U \| R \| B \| T] ) fieldname, tablodaki bir alan adıyla aynı olan metindir. Alan adının, örneğin boşluklar içeriyorsa, düz çift tırnak işaretleri veya köşeli ayraçlar içine alınması gerektiğini unutmayın. Alan adları kimi zaman açık şekilde kullanılabilir durumda olmayabilir. Bu durumda farklı gösterim kullanılır. @fieldnumber, sınırlanmış bir tablo dosyasındaki alan numarasını temsil eder. Önünde "@" yer alan pozitif bir tamsayı olmalıdır. Numaralandırma her zaman 1'den başlar ve alan sayısına kadar gider. @startpos:endpos, sabit uzunluklu kayıtların bulunduğu bir dosyada alanın başlangıç ve bitiş konumlarını temsil eder. Konumların her ikisi de pozitif tamsayı olmalıdır. Bu iki sayının öncesinde "@" gelmeli ve iki sayı iki nokta üst üste ile ayrılmalıdır. Numaralandırma her zaman 1'den başlar ve konumların sayısına kadar gider. Son alanda, bitiş konumu olarak n kullanılır. @startpos:endpos öğesinin hemen ardından I veya U karakterleri gelirse, okunan baytlar imzalanmış ikili (I) veya imzalanmamış (U) tamsayı (Intel bayt sırası) olarak yorumlanır. Okunan konumların sayısı 1, 2 veya 4 olmalıdır. @startpos:endpos öğesinin hemen ardından R karakteri gelirse, okunan baytlar ikili gerçek sayı (IEEE 32 bit ya da 64 bit kayan nokta) olarak yorumlanır. Okunan konumların sayısı 4 veya 8 olmalıdır. @startpos:endpos öğesinin hemen ardından B karakteri gelirse, okunan baytlar COMP-3 standardına göre BCD (Binary Coded Decimal) sayıları olarak yorumlanır. İstenen sayıda bayt belirtilebilir. expression, aynı tablodaki bir veya birkaç alanı temel alan bir sayısal fonksiyon veya bir dize fonksiyonu olabilir. Daha fazla bilgi için ifadelerin söz dizimine bakın. Alana yeni bir ad atamak için as ifadesi kullanılır.
from	Verilerin klasör kullanılarak bir dosyadan yüklenmesi gerekiyorsa from kullanılır. file ::= [ path ] filename format-spec ::= ( fspec-item { , fspec-item } ) Kişisel alan: [lib://DataFiles/xyz.qvd] DataFiles bağlantısı kullanırken bir klasör hiyerarşisi oluşturamaz veya referans veremezsiniz. Örneğin, aşağıdaki desteklenmez: [lib://DataFiles/subfolder1/xyz.qvd] Paylaşılan alan: [lib://TeamSharedSpace:DataFiles/xyz.qvd]
from_field	Daha önceden yüklenmiş bir alandan veri yüklenmesi gerekirse from_field kullanılır. fieldassource::=(tablename, fieldname) Alan, daha önceden yüklenen tablename ve fieldname adıdır. format-spec ::= ( fspec-item {, fspec-item } ) Biçim belirtimi, ayraçlar içinde, birden fazla biçim belirtimi öğesinin listesinden oluşur.
inline	Verilerin kod içerisine yazılması ve dosyadan yüklenmemesi gerekirse inline kullanılır. data ::= [ text ] inline cümlesiyle girilen veriler çift tırnak işareti veya köşeli ayraçlar içine alınmalıdır. Bunlar arasındaki metinler bir dosyanın içeriğiyle aynı şekilde yorumlanır. Bu nedenle, bir metin dosyasında yeni satır eklerken, bunu aynı zamanda inline cümlesinin metninde de yapmalı, yani kodu yazarken Enter tuşuna basmalısınız. Sütun sayısı, ilk satıra bağlı olarak tanımlanır. format-spec ::= ( fspec-item {, fspec-item } ) Biçim belirtimi, ayraçlar içinde, birden fazla biçim belirtimi öğesinin listesinden oluşur.
resident	Daha önceden yüklenmiş bir tablodan veri yüklenmesi gerekirse resident kullanılır. table label, asıl tabloyu oluşturan LOAD veya SELECT deyimlerinin önünde bulunan bir etikettir. Bu etiketin sonuna iki nokta üst üste eklenmelidir. Daha önce yüklenmiş bir tablodan verileri yükleme Tablo etiketleri
autogenerate	autogenerate, verilerin otomatik olarak Qlik Sense tarafından oluşturulması gerekiyorsa kullanılır. size ::= number Number, oluşturulacak kayıt sayını belirten bir tamsayıdır. Alan listesi, Peek fonksiyonuyla daha önce yüklenen bir tabloda tek bir alan değerine referansta bulunmadığınız sürece, harici veri kaynağından veya daha önce yüklenen tablodan veri gerektiren ifadeler içermemelidir.
where	where, bir kaydın seçime dahil edilmesi gerekip gerekmediğini belirtmek için kullanılan bir cümledir. criterion değeri True ise seçim dahil edilir. criterion, mantıksal bir ifadedir.
while	while, bir kaydın tekrar tekrar okunması gerekip gerekmediğini belirtmek için kullanılan bir cümledir. criterion değeri True olduğu sürece aynı kayıt okunur. Kullanışlı olması için, while cümlesi genellikle IterNo( ) fonksiyonunu içermelidir. criterion, mantıksal bir ifadedir.
group by	group by, verilerin hangi alan üzerinde toplanması (gruplanması) gerektiğini tanımlamak için kullanılan bir cümledir. Toplama alanları yüklenen ifadelere bir şekilde dahil edilmelidir. Yüklenen ifadelerde toplama işlevleri dışında toplama alanlarından başka herhangi bir alan kullanılamaz. groupbyfieldlist ::= (fieldname { ,fieldname } )
order by	order by, yerleşik tablonun kayıtlarını, load deyimi tarafından işlenmeden önce sıralamak için kullanılan bir cümledir. Yerleşik tablo bir veya daha fazla alana göre artan veya azalan olarak sıralanabilir. Sıralama, birincil olarak sayısal değere ve ikincil olarak da ulusal harmanlama düzenine göre yapılır. Bu cümle yalnızca veri kaynağı yerleşik bir tablo olduğunda kullanılabilir. Düzenleme alanları, yerleşik tablonun hangi alana göre sıralanacağını belirler. Bu alan, adıyla veya yerleşik tablodaki sayısıyla belirlenebilir (birinci alan 1 numaradır). orderbyfieldlist ::= fieldname [ sortorder ] { , fieldname [ sortorder ] } sortorder, artan için asc veya azalan için desc şeklindedir. Herhangi bir sortorder belirtilmezse asc olduğu varsayılır. fieldname, path, filename ve aliasname sırasıyla kendi adlarının ifade ettiklerini temsil eden metin dizeleridir. Kaynak tablodaki herhangi bir alan fieldname olarak kullanılabilir. Ancak, as cümlesiyle oluşturulan alanlar (aliasname) kapsam dışıdır ve aynı load deyiminin içerisinde kullanılamaz.

from, inline, resident, from_fielduzantı veya autogenerate cümlesi aracılığıyla bir veri kaynağı verilmezse, veriler hemen ardından gelen SELECT ya da LOAD deyiminin sonucundan yüklenir. Bunun ardından gelen deyimin bir öneki bulunmamalıdır.

Daha önce yüklenmiş bir tablodan verileri yükleme

DataFiles bağlantılarının dosya uzantısı büyük-küçük harfe duyarlıdır. Örneğin: .qvd.

Examples:

Sınırlanmış dosyadan yalnızca üç belirli alanı yükleyin:

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

Etiketleri olmayan bir dosyayı yüklerken ilk alanı A ve ikinci alanı B olarak yeniden adlandırın:

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

FirstName, bir boşluk karakteri ve LastName birleşimi olarak Name öğesini yükleyin:

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

Quantity, Price ve Value (Quantity ve Price öğelerinin çarpımı) öğelerini yükleyin:

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

Yalnızca benzersiz kayıtları yükleyin; çoğaltılan kayıtlar atılır:

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

Yalnızca Litres alanının sıfır üzerinde bir değere sahip olduğu kayıtları yükleyin:

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

CatID ve Category adında iki alan olmak üzere satır içi verileri içeren bir tablo yükleyin:

LOAD * Inline

[CatID, Category

0,Regular

1,Occasional

2,Permanent];

UserID, Password ve Access adında üç alan olmak üzere satır içi verileri içeren bir tablo yükleyin:

LOAD * Inline [UserID, Password, Access

A, ABC456, User

B, VIP789, Admin];

10.000 satırlı bir tablo yükleyin. A alanı okunan kayıt sayısını (1,2,3,4,5...) ve B alanı da 0 ile 1 arasında rastgele bir sayı içerecektir:

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

autogenerate deyiminden sonra paranteze izin verilir, ancak bu gerekli değildir.

İlk olarak bir sınırlanmış tablo dosyası yüklüyor ve tab1 olarak adlandırıyoruz:

tab1:

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

Önceden yüklenmiş tab1 tablosundan dosyaları tab2 olarak yükleyin:

tab2:

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

Önceden yüklenmiş tab1 tablosundan dosyaları yükleyin; ancak yalnızca A değerinin B değerinden büyük olduğu kayıtları yükleyin:

tab3:

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

Önceden yüklenmiş tab1 tablosundan alanları, A ölçütüne göre sıralanmış olarak yükleyin:

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

Önceden yüklenmiş tab1 tablosundan alanları, birinci alana ve sonra da ikinci alana göre sıralanmış olarak yükleyin:

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

Önceden yüklenmiş tab1 tablosundan değerleri, C ölçütüne göre azalan düzende, ardından B ölçütüne göre artan düzende ve sonra da ilk alana göre azalan düzende sıralanmış olarak yükleyin:

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

Daha önce yüklenmiş Characters tablosundan Types alanını A olarak yükleyin:

LOAD A from_field (Characters, Types);

Ardından gelen SELECT deyiminde yüklenen Table1 öğesinden A, B ve hesaplanan X ve Y alanlarını yükleyin:

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

SELECT A,B,C,D from Table1;

ArtNo öğesine göre gruplandırılmış (toplanmış) alanları yükleyin:

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

Week ve ArtNo öğesine göre gruplandırılmış (toplanmış) alanları yükleyin:

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

Bu örnekte, her bir öğrencinin notlarını tek bir alana sıkıştırılmış olarak içeren Grades.csv adında bir giriş dosyamız var:

Student,Grades

Mike,5234

John,3345

Pete,1234

Paul,3352

Notlar, 1-5 ölçeğinde Math, English, Science ve History derslerini temsil etmektedir. IterNo( ) fonksiyonunun sayaç olarak kullanıldığı bir while cümlesi ile her bir kaydı birkaç kez okuyarak, notları ayrı değerler halinde ayırabiliriz. Her okumada, öğrenci notu Mid fonksiyonu ile ayrıştırılıp Grade alanına depolanır ve ders de pick fonksiyonunun kullanımıyla seçilip Subject alanına depolanır. Son while cümlesi, tüm notların (bu örnekte öğrenci başına dört not) okunduğunu kontrol etmek için kullanılan ve okunduysa, bir sonraki öğrenci kaydının okunması gerektiği anlamına gelen sınamayı içerir.

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

Sonuçta şu verileri içeren bir tablo ortaya çıkar:

Resulting data table

Aşağıdaki örnek veriler kullanılır.

Değerler: Load Rand() as A, Rand() as B, Rand() as C AutoGenerate(50);

Bir fonksiyon kullanarak veri yükleme

Bu örneklerde, Calculate(Parameter1, Parameter2) özel fonksiyonunu içeren P adlı bir analiz bağlantısı eklentimizin olduğunu varsayarız. Fonksiyon, Field1 ve Field2 alanlarını içeren Results tablosunu döndürür.

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

A ve C alanları fonksiyona gönderilirken döndürülen tüm alanları yükleyin.

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

A ve C alanları fonksiyona gönderilirken yalnızca Field1 alanını yükleyin.

Load * Extension P.Calculate( Values );

A ve B alanları fonksiyona gönderilirken döndürülen tüm alanları yükleyin. Alanlar belirtilmediğinden, tabloda birinci olarak sıralanan A ve B kullanılır.

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

C alanı, fonksiyonun her iki parametresine gönderilirken döndürülen tüm alanları yükleyin.

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

Dize olarak zorlanan A alanı ve sayısal olarak zorlanan B alanı fonksiyona gönderilirken döndürülen tüm alanları yükleyin.

Bir kodu değerlendirerek veri yükleme

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

A ve B değerlerini gönderirken q kodu tarafından döndürülen tabloyu yükleyin.

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

A ve B değerleri gönderilirken My_R_Script değişkeninde saklanan kod tarafından döndürülen tabloyu yükleyin.

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

B değerleri, D, A ve C olarak yeniden adlandırılmış şekilde gönderilirken My_R_Script değişkeninde saklanan kod tarafından döndürülen tabloyu yükleyin. * işareti kullanıldığında, referansta bulunulmayan diğer kalan alanlar gönderilir.