Ana içeriğe geç Tamamlayıcı içeriğe geç

Store

Store ifadesi bir QVD, Parquet, CSV veya TXT dosyası oluşturur.

Söz Dizimi:  

Store [ fieldlist from] table into filename [ format-spec ];

Deyim, açıkça adlandırılmış bir QVD, Parquet veya metin dosyası oluşturur.

Bir Parquet içine depolamadığınız sürece deyim yalnızca bir veri tablosundan alanları dışa aktarabilir. Birkaç tablodan alanlar bir QVD, CSV veya TXT dosyasına aktarılacaksa dışa aktarılması gereken veri tablosunu oluşturmak için kodda önceden açık bir join yapılmalıdır. Parquet dosyalarında verileri iç içe geçirerek tek bir Parquet içinde birden fazla tablo saklayabilirsiniz.

Metin değerleri, CSV dosyasına UTF-8 biçiminde dışa aktarılır. Bir sınırlayıcı belirtilebilir, bkz. LOAD. Bir CSV dosyasına yönelik store deyimi BIFF dışa aktarımı desteklemez.

Bilgi notuDoğru biçimlendirilmemiş verilerin bulunduğu bazı durumlarda alanlar, verilerin doğru şekilde yorumlanmasını sağlamak için çift tırnak işareti içine alınır. Bu, örneğin alanda tırnak işareti, virgül, boşluk veya satır sonu gibi karakterler olduğunda gerçekleşir.

Bağımsız Değişkenler:  

Store komutu bağımsız değişkenleri
Bağımsız Değişken Açıklama
fieldlist::= ( * | field) { , field } )

Seçilecek alanların listesi. Alan listesi olarak * kullanılması tüm alanlara işaret eder. 

field::= fieldname [as aliasname ]

fieldname, table içindeki bir alan adıyla aynı olan metindir. (Boşluklar veya diğer standart olmayan karakterler içermesi halinde alan adının düz çift tırnak işaretleri veya köşeli ayraçlar içine alınması gerektiğini unutmayın.)

aliasname, sonuç olarak elde edilen QVD veya CSV dosyasında kullanılacak alan için bir alternatif addır.

table Veriler için kaynak olarak kullanılacak önceden yüklenmiş bir tabloyu temsil eden kod etiketi.
filename

Mevcut bir klasör veri bağlantısının geçerli yolu dahil hedef dosyanın adı.

Örnek: 'lib://Table Files/target.qvd'

Eski kod oluşturma modunda, aşağıdaki yol biçimleri de desteklenir:

  • mutlak

    Örnek: c:\data\sales.qvd

  • Qlik Sense uygulama çalışma dizinine göreceli.

    Örnek: data\sales.qvd

    Yol atlanırsa, Qlik Sense bu dosyayı Directory deyiminde belirtilen dizinde saklar. Directory deyimi yoksa Qlik Sense dosyayı C:\Users\{user}\Documents\Qlik\Sense\Apps çalışma dizininde depolar.

format-spec ::=( ( txt | qvd | parquet), compression is codec)

Biçim belirtimini bu dosya biçimlerinden biri olarak ayarlayabilirsiniz. Biçim belirtimi atlanırsa qvd olduğu varsayılır.

  • CSV ve TXT dosyaları için txt.

  • QVD dosyaları için qvd.

  • Parquet dosyaları için parquet.

parquet kullanıyorsanız compression is ile hangi sıkıştırma codec'inin kullanılacağını da ayarlayabilirsiniz. compression is ile sıkıştırma codec'ini belirtmezseniz snappy kullanılır. Aşağıdaki sıkıştırma ayarları kullanılabilir:

  • uncompressed

  • snappy

  • gzip

  • lz4

  • brotli

  • zstd

  • lz4_hadoop

Örnek:

Store mytable into [lib://AttachedFiles/myfile.parquet] (parquet, compression is lz4);

Örnekler:

Store mytable into xyz.qvd (qvd);

Store * from mytable into 'lib://FolderConnection/myfile.qvd';

Store Name, RegNo from mytable into xyz.qvd;

Store Name as a, RegNo as b from mytable into 'lib://FolderConnection/myfile.qvd';

Store mytable into myfile.txt (txt);

Store mytable into myfile.parquet (parquet);

Store * from mytable into 'lib://FolderConnection/myfile.qvd';

Parquet dosyalarında saklama

Parquet, her alanın belirli bir türde veri (örneğin in32, çift, zaman damgası veya metin) içerdiği, güçlü bir şekilde yazılmış bir dosya biçimidir. Qlik Sense, dahili verileri, farklı kaynaklardan gelen verilerin aynı alanlarda karıştırılabildiği, detaya girmeden yazılmış bir dual olarak kaydeder. Parquest'teki her bir alanda dual'in sadece bir parçası kaydedilebildiğinden, her bir alanın ne içerdiğini bilmek önemlidir. Varsayılan olarak Qlik Sense, alanın nasıl kaydedilmesini gerektiğini belirlemek için alan türünü kullanır. Verileri Parquet dosyalarında belirli bir biçimde kaydederken alanlarınızı yüklerken ne tür veriler olduğunu belirtmeniz gerekir. Verileri bir Parquet dosyasındaki uyumlu olmayan alanlara, örneğin ayıları metin alanına veya metni bir zaman damgası alanına kaydetmeye çalışırsanız boş değerler elde edersiniz.

Parquet'e kaydetmeyi planladığınız verileri yüklerken varsayılan davranış değiştirilebilir. Bunu veri türünüzü değiştirecek şekilde biçimlendirebilir veya Parquet'te belirli sütun türlerini zorla uygulayacak şekilde etiketleyebilirsiniz.

Parquet'te depolama için verileri biçimlendirme

Verilerinizi sınıflandırmak için Qlik Sense biçimlendirme işlevlerini kullanabilirsiniz. Örneğin Text(), Num(), Interval() veya Timestamp(), Parquet'te veri kaydederken veri biçimlerini zorla uygulayabilir. Qlik Sense, alan özelliklerine ve otomatik alan etiketlerine dayanarak neredeyse 20 veri türüne veri kaydedebilir. Daha fazla bilgi için bk. Yorumlama fonksiyonları

Örnek: Verileri Num() ve Text() ile biçimlendirme

Aşağıdaki örnekte, verilerin Parquet'te depolamak için hazırlanması gösterilmektedir. Num(), sayı alanına uygulanır. Text() hem metin hem karışık için uygulanır. Karışık olması durumunda Text(), Parquet'te sayı alanı gibi davranılmasını engeller ve metin değerlerinin boş değerlere değiştirilmesini sağlar.

Data: LOAD * INLINE [ num, text, mixed 123.321, abc, 123 456.654, def, xyz 789.987, ghi, 321 ]; Format:
NoConcatenate LOAD num, text, Text(mixed) as mixed RESIDENT Data; STORE Format INTO [lib://AttachedFiles/Tmp.parquet] (parquet);

Parquet'te depolamak için verileri etiketleme

Verileri Parquet'e kaydederken belirli sütun türlerini zorla uygulamak için verilerinizi $parquet etiketleriyle etiketleyin. Her veri türü, ilgili kontrol etiketini ekleyerek zorla uygulanabilir. Örneğin bir alanı Parquet'te INT32 olarak kaydedecekseniz komut dosyasında $parquet-int32 ile etiketleyin. Veri türüne bağlı olarak dual verinin dizesi veya sayısal temsili kaydedilecektir.

Aşağıdaki Parquest kontrol etiketleri, Parquest dosyalarına kaydetmek için alanları etiketlemek üzere kullanılabilir.

Parquet kontrol etiketleri
Kontrol etiketiDualFiziksel türMantıksal türDönüştürülmüş tür
$parquet-booleanSayıBOOLEANNONENONE
$parquet-int32SayıINT32NONENONE
$parquet-int64SayıINT64NONENONE
$parquet-floatSayıFLOATNONENONE
$parquet-doubleSayıDOUBLENONENONE
$parquet-bytearrayDizeBYTE_ARRAYNONEUTF8
$parquet-bytearrayfixSayıFIXED_LEN_BYTE_ARRAYNONEDECIMAL
$parquet-decimalSayıINT64DECIMALDECIMAL
$parquet-dateSayıINT32DATEDATE
$parquet-timeSayıINT64TIMETIME_MICROS
$parquet-timestampSayıINT64TIMESTAMPTIMESTAMP_MICROS
$parquet-stringDizeBYTE_ARRAYSTRINGUTF8
$parquet-enumDizeBYTE_ARRAYENUMENUM
$parquet-intervalSayıFIXED_LEN_BYTE_ARRAYINTERVALINTERVAL
$parquet-jsonDizeBYTE_ARRAYJSONJSON
$parquet-bsonDizeBYTE_ARRAYBSONBSON
$parquet-uuidDizeFIXED_LEN_BYTE_ARRAYUUIDNONE

Örnek: Parquet'te depolamak için verileri etiketleme

Bu örnekte iki etiket, Parquet için verileri tanımlamak üzere kullanılır. num alanı, Parquet'te INT32 şeklinde ayarlanacak bir sayı alanı olarak tanımlamak üzere $parquet-int32 ile etiketlenir.

Data: LOAD * INLINE [ num, text, 123.321, abc 456.654, def 789.987, ghi ]; TAG num WITH '$parquet-int32'; STORE Format INTO [lib://AttachedFiles/Tmp.parquet] (parquet);

İç içe geçirilmiş verileri Parquet dosyalarında saklama

Birden fazla tabloyu yapılandırılmış verilerde iç içe geçirerek Parquet dosyalarında saklayabilirsiniz. Store, yapılandırılmış düğümleri destekler ve düğümleri bir yıldız şemasında listeler. Tek tablolar, Delimiter is belirteci kullanılarak iç içe modda da saklanabilir.

Tabloları depolarken dahil etmek istediğiniz tabloları virgüllerle ayırarak belirtin. Örneğin: STORE Table1, Table2, Table3 INTO [lib://<file location>/<file name>.parquet] (parquet);. Store ifadesinde bir alan listesi kullanarak hangi alanların saklanacağını kontrol edebilirsiniz. Örneğin, STORE Field1, Field2, FROM Table1, Table2 INTO [lib://<file location>/<file name>.parquet] (parquet);. Alan listesindeki tüm alanlar, listelenen alanlardan en az birinde olmalıdır. Store deyimindeki ilk tablo, yıldız şemasında değer tablosu olarak kullanılacaktır.

Alan adları, grupların oluşturulma ve iç içe geçirilme şeklini kontrol etmek için kullanılır. Varsayılan olarak alan adları, noktayla düğümlere ayrılır (.). Sınırlayıcı, FieldNameDelimiter sistem değişkenini ayarlayarak veya Sınırlayıcı: belirticisi kullanılarak değiştirilebilir. Belirtici, sistem değişkenini geçersiz kılar. Daha fazla bilgi için bkz. Veri yükleme düzenleyicisinde değişkenlerle çalışma.

Alan adları, sınırlayıcıyla ayrılır ve parçalar, iç içe geçmiş gruplarla şema oluşturmak için kullanılır. Örneğin STORE Field1, Field1.Field2, Field1.Field3, Field1.Field4 FROM Table1 INTO [nested.parquet] (parquet, delimiter is '.');, Fields1, Field2 ve Field3, Field4 ile iki grup (Group1 ve Group2) oluşturacaktır.

Bilgi notuGruplar ve alanlar, şemadaki bir düğümle aynı ada sahip olmayabilir. Örneğin, Adres belirsiz ve hem bir veri alanı hem de grup olduğu için STORE Address, Address.Street INTO [nested.parquet] (parquet, delimiter is '.''); başarısız olacaktır.

İç içe geçirilmiş verileri Parquet içinde depolarken tablolar arasındaki anahtarlar, şemada bağlantı düğümlerine dönüşür. Tablolar, şemada yapılandırılmış düğümlere dönüştürülür. Alan adlarını kullanarak varsayılan dönüşümü geçersiz kılabilirsiniz.

Örnek: İç içe geçirilmiş verileri bir Parquet dosyasında saklama

company: LOAD * INLINE [ company, contact A&G, Amanda Honda Cabro, Cary Frank Fenwick, Dennis Fisher Camros, Molly McKenzie ]; salesrep: LOAD * INLINE [ company, salesrep A&G, Bob Park Cabro, Cezar Sandu Fenwick, Ken Roberts Camros, Max Smith ]; headquarter: LOAD * INLINE [ company, country, city A&G, USA, Los Angeles Cabro, USA, Albuquerque Fenwick, USA, Baltimore Camros, USA, Omaha ]; region: LOAD * INLINE [ region, city West, Los Angeles Southwest, Albuquerque East, Baltimore Central, Omaha ]; STORE company, salesrep, headquarter, region INTO [lib://AttachedFiles/company.parquet] (parquet) DROP TABLES company, salesrep, headquarter, region;

Ortaya çıkan Parquet dosyası aşağıdaki şemaya sahiptir:

company (String) contact (String) company:salesrep (List) salesrep (Group) salesrep (String) company:headquarter (List) headquarter (Group) country (String) city (String) city:region (List) region (Group) region (String)

Sınırlamalar

Parquet içinde depolanan iç içe geçirilmiş veriler aşağıdaki sınırlamalara sahiptir:

  • Mağaza, harita düğümlerini desteklemez.

  • Depolama, iç içe geçirilmiş parquet dosyaları yüklemesinden oluşturulan anahtar alanları içermez.

  • Tablolardan alınan, anahtar alanlarla bağlanmayan verileri birlikte depolayamazsınız.

  • İç içe geçirilmiş dosya, veri modelinin normalleştirmesini kaldırır. Referans verilmeyen değerler kaydedilmeyecek ve birden çok kez referans verilen değerler kopyalanacaktır.

Bu sayfa size yardımcı oldu mu?

Bu sayfa veya içeriği ile ilgili bir sorun; bir yazım hatası, eksik bir adım veya teknik bir hata bulursanız, bize bildirin, düzeltelim!