Veri alma özellikleri

  • Makale

Şunlar için geçerlidir: ✅Microsoft Fabric✅Azure Veri Gezgini

Veri alımı, verilerin tabloya eklendiği ve sorgu için kullanılabilir hale getirildiği işlemdir. Anahtar sözcüğünden sonra alma komutuna with özellikler eklersiniz.

Alma özellikleri

Önemli

Kuyruğa alınan veri alımı özellikleri kullanılarak toplu olarak alınır. Farklı ConstValue değerleri gibi daha farklı alım eşleme özellikleri kullanıldıkça, alma işlemi o kadar parçalanır ve bu da performans düşüşlerine yol açabilir.

Aşağıdaki tabloda desteklenen özellikler listelenip açıklanır ve örnekler sağlanır:

Özellik Açıklama Örnek
ingestionMapping Kaynak dosyadaki verilerin tablodaki gerçek sütunlara nasıl eşlendiğini gösteren dize değeri. Değeri ilgili format eşleme türüyle tanımlayın. Bkz. veri eşlemeleri. with (format="json", ingestionMapping = "[{\"column\":\"rownumber\", \"Properties\":{\"Path\":\"$.RowNumber\"}}, {\"column\":\"rowguid\", \"Properties\":{\"Path\":\"$.RowGuid\"}}]")
(kullanım dışı: avroMapping, csvMapping, jsonMapping)
ingestionMappingReference Adlandırılmış eşleme ilkesi nesnesi kullanılarak kaynak dosyadaki verilerin tablodaki gerçek sütunlara nasıl eşlendiğini gösteren dize değeri. Değeri ilgili format eşleme türüyle tanımlayın. Bkz. veri eşlemeleri. with (format="csv", ingestionMappingReference = "Mapping1")
(kullanım dışı: avroMappingReference, csvMappingReference, jsonMappingReference)
creationTime Alınan veri kapsamlarının oluşturma zamanında kullanılacak datetime değeri (ISO8601 dizesi olarak biçimlendirilir). Belirtilmezse geçerli değer (now()) kullanılır. Bekletme ilkesinin doğru şekilde uygulanması için eski verileri alırken varsayılan değeri geçersiz kılma yararlı olur. Belirtildiğinde, hedef tablonun etkin Kapsam birleştirme ilkesindeki özelliğin belirtilen değerle hizalandığından emin olunLookback. with (creationTime="2017-02-13")
extend_schema Belirtildiyse komutuna tablonun şemasını genişletme talimatı veren bir Boole değeri (varsayılan olarak falseolarak kullanılır). Bu seçenek yalnızca ve .set-or-append komutları için .append geçerlidir. yalnızca izin verilen şema uzantılarının sonunda tabloya daha fazla sütun eklenir. Özgün tablo şeması ise (a:string, b:int)geçerli bir şema uzantısı olabilir (a:string, b:int, c:datetime, d:string), ancak (a:string, c:datetime) geçerli olmaz
folder Sorgudan alma komutları için tabloya atanacak klasör. Tablo zaten varsa, bu özellik tablonun klasörünü geçersiz kılar. with (folder="Tables/Temporary")
format Veri biçimi (desteklenen veri biçimlerine bakın). with (format="csv")
ingestIfNotExists Tabloda aynı değere sahip bir etiketle etiketlenmiş veriler varsa, belirtilirse alımın başarılı olmasını engelleyen bir ingest-by: dize değeri. Bu, etkili veri alımını sağlar. Daha fazla bilgi için bkz . alma ölçütü: etiketler. Özellikler with (ingestIfNotExists='["Part0001"]', tags='["ingest-by:Part0001"]') , etiketli ingest-by:Part0001 veriler zaten varsa geçerli alımı tamamlamadığını gösterir. Henüz yoksa, bu yeni alımın bu etiket ayarlanmış olması gerekir (gelecekte aynı verileri yeniden alma girişiminde bulunulması durumunda.)
ignoreFirstRecord olarak ayarlanırsa truealımın her dosyanın ilk kaydını yoksayması gerektiğini gösteren boole değeri. Bu özellik, dosyadaki CSVilk kayıt sütun adlarıysa, ve benzer biçimlerdeki dosyalar için kullanışlıdır. Varsayılan olarak varsayılır false . with (ignoreFirstRecord=false)
policy_ingestiontime Belirtilirse, bu komut tarafından oluşturulan bir tabloda Alma Zamanı İlkesi'nin etkinleştirilip etkinleştirilmeydiğini açıklayan boole değeri. Varsayılan değer: true. with (policy_ingestiontime=false)
recreate_schema Belirtildiyse komutun tablonun şemasını yeniden oluşturup oluşturamayacağını açıklayan boole değeri. Bu özellik yalnızca komutu için .set-or-replace geçerlidir. Her ikisi de ayarlandıysa bu özellik özelliğinden extend_schema önceliklidir. with (recreate_schema=true)
tags JSON dizesi olarak biçimlendirilmiş, alınan verilerle ilişkilendirilecek etiketlerin listesi with (tags="['Tag1', 'Tag2']")
TreatGzAsUncompressed olarak ayarlanırsa trueuzantılı .gz dosyaların sıkıştırılmadığını gösteren boole değeri. Bu bayrak bazen Amazon AWS S3'ten alırken gereklidir. with (treatGzAsUncompressed=true)
validationPolicy CSV biçimi kullanılarak temsil edilen verilerin alımı sırasında hangi doğrulamaların çalıştırıldığını gösteren bir JSON dizesi. Farklı seçeneklerin açıklaması için bkz . Veri alımı . with (validationPolicy='{"ValidationOptions":1, "ValidationImplications":1}') (bu varsayılan ilkedir)
zipPattern ZIP arşivi olan depolama alanından veri alırken bu özelliği kullanın. Bu, ZIP arşivinde hangi dosyaların alındığını seçerken kullanılacak normal ifadeyi gösteren bir dize değeridir. Arşivdeki diğer tüm dosyalar yoksayılır. with (zipPattern="*.csv")

İlgili içerik