Azure Veri Gezgini veri alımı özellikleri

  • Makale

Veri alımı, verilerin bir tabloya eklendiği ve Azure Veri Gezgini'de 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 Azure Veri Gezgini tarafından desteklenen özellikler listelenir, bunlar 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 kullanarak 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 tarih saat değeri (ISO8601 dizesi olarak biçimlendirilir). Belirtilmemişse 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 Belirtilirse komutuna tablonun şemasını genişletmesini belirten 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. İzin verilen tek şema uzantılarının sonunda tabloya ek sütunlar 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, bir kez etkili veri alımı 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ın tamamlanmadığını gösterir. Henüz yoksa, bu yeni alımda bu etiket ayarlanmış olmalıdır (gelecekteki bir alım aynı verileri yeniden almaya çalışırsa.)
ignoreFirstRecord olarak ayarlanırsa true, alımın her dosyanın ilk kaydını yoksayması gerektiğini belirten bir 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 Alım Zamanı İlkesi'nin etkinleştirilip etkinleştirilmeydiğini açıklayan boole değeri. Varsayılan değer: true. with (policy_ingestiontime=false)
recreate_schema Belirtilirse komutun tablonun şemasını yeniden oluşturup oluşturamayacağını açıklayan bir Boole değeri. Bu özellik yalnızca komutu için .set-or-replace geçerlidir. Her ikisi de ayarlandıysa, bu özellik özelliğinden önceliklidir extend_schema . with (recreate_schema=true)
tags JSON dizesi olarak biçimlendirilmiş, alınan verilerle ilişkilendirilecek etiketlerin listesi with (tags="['Tag1', 'Tag2']")
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 aslında 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