bag_unpack eklentisi

Sürüm açılan listesini kullanarak hizmetler arasında geçiş yapın. Gezinti hakkında daha fazla bilgi edinin.
Şunlar için geçerlidir: ✅ Microsoft Fabric ✅ Azure Veri Gezgini

Eklenti, bag_unpack her özellik paketi üst düzey yuvasını sütun olarak değerlendirerek türünde dynamictek bir sütunu açar. Eklenti işleciyle birlikte çağrılır evaluate .

Sözdizimi

T|evaluatebag_unpack( Sütunu [,OutputColumnPrefix ] [,columnsConflict ] [,ignoredProperties ] ) [:OutputSchema]

Söz dizimi kuralları hakkında daha fazla bilgi edinin.

Parametreler

Ad Tür Zorunlu Açıklama
T string ✔️ Sütununun paketten çıkarılacağı tablosal giriş.
Sütun dynamic ✔️ Paketten çıkarılmayan T sütunu.
OutputColumnPrefix string Eklenti tarafından üretilen tüm sütunlara eklenecek ortak bir ön ek.
columnsConflict string Sütun çakışma çözümlemesinin yönü. Geçerli değerler:
error - Sorgu hata üretir (varsayılan)
replace_source - Kaynak sütun değiştirildi
keep_source - Kaynak sütun tutulur
ignoredProperties dynamic Göz ardı edilecek isteğe bağlı bir çanta özellikleri kümesi. }
OutputSchema Eklenti çıkışı için bag_unpack sütun adlarını ve türlerini belirtin. Söz dizimi bilgileri için bkz . Çıktı şeması söz dizimi ve etkilerini anlamak için bkz. Performansla ilgili dikkat edilmesi gerekenler.

Çıktı şeması söz dizimi

( ColumnName:ColumnType [, ...])

Çıkışa kaynak tablonun tüm sütunlarını eklemek için ilk parametre olarak aşağıdaki gibi joker karakter * kullanın:

( * , ColumnName:ColumnType [, ...])

Performansla ilgili dikkat edilmesi gerekenler

Eklentiyi OutputSchema olmadan kullanmak, büyük veri kümelerinde ciddi performans etkileri olabilir ve bundan kaçınılmalıdır.

OutputSchema'nın sağlanması sorgu altyapısının sorgu yürütmeyi iyileştirmesine olanak tanır. Giriş verilerini ayrıştırmaya ve çözümlemeye gerek kalmadan çıkış şemasını belirleyebilir. Giriş verileri büyük veya karmaşık olduğunda OutputSchema faydalıdır. Eklentiyi tanımlı bir OutputSchema ile ve olmadan kullanmanın performans üzerindeki etkileri olan örnekler bölümüne bakın.

Döndürülenler

Eklenti, bag_unpack tablosal girişi (T) kadar kaydı olan bir tablo döndürür. Tablonun şeması, aşağıdaki değişikliklerle tablosal girişinin şemasıyla aynıdır:

  • Belirtilen giriş sütunu (Sütun) kaldırılır.
  • Her sütunun adı, isteğe bağlı olarak OutputColumnPrefix ön ekine sahip olan her yuvanın adına karşılık gelir.
  • Her sütunun türü, aynı yuvanın tüm değerleri aynı türe sahipse yuvanın türü veya dynamicdeğer türü farklıysa olur.
  • Şema, T'nin en üst düzey özellik paketi değerlerinde ayrı yuvalar olduğu kadar çok sütunla genişletilir.

Not

  • OutputSchema belirtmezseniz, eklenti çıkış şeması giriş veri değerlerine göre değişir. Eklentinin farklı veri girişlerine sahip birden çok yürütülmesi farklı çıkış şemaları oluşturabilir.
  • OutputSchema belirtilirse, joker karakter kullanılmadığı sürece eklenti yalnızca * tanımlanan sütunları döndürür.
  • Giriş verilerinin tüm sütunlarını ve OutputSchema'da tanımlanan sütunları döndürmek için OutputSchema'da bir joker karakter * kullanın.

Tablosal şema kuralları giriş verilerine uygulanır. Özellikle:

Eklenti null değerleri yoksayar.

Örnekler

Bu bölümdeki örneklerde, kullanmaya başlamanıza yardımcı olması için söz diziminin nasıl kullanılacağı gösterilmektedir.

Bir torbayı genişletme:

Sorguyu çalıştırma

datatable(d:dynamic)
[
    dynamic({"Name": "John", "Age":20}),
    dynamic({"Name": "Dave", "Age":40}),
    dynamic({"Name": "Jasmine", "Age":30}),
]
| evaluate bag_unpack(d)

Çıktı

Age Name
20 John
40 Demirci
30 Yasemin

Bir torbayı OutputColumnPrefix genişletin ve önek içeren sütun adları oluşturmak için seçeneğini kullanın:

Sorguyu çalıştırma

datatable(d:dynamic)
[
    dynamic({"Name": "John", "Age":20}),
    dynamic({"Name": "Dave", "Age":40}),
    dynamic({"Name": "Jasmine", "Age":30}),
]
| evaluate bag_unpack(d, 'Property_')

Çıktı

Property_Age Property_Name
20 John
40 Demirci
30 Yasemin

Bir torbayı columnsConflict genişletin ve dinamik sütun ile mevcut sütun arasındaki sütun çakışmasını çözmek için seçeneğini kullanın:

Sorguyu çalıştırma

datatable(Name:string, d:dynamic)
[
    'James', dynamic({"Name": "John", "Age":20}),
    'David', dynamic({ "Age":40}),
    'Emily', dynamic({"Name": "Jasmine", "Age":30}),
]
| evaluate bag_unpack(d, columnsConflict='replace_source') // Replace old column Name by new column

Çıktı

Name Age
John 20
40
Yasemin 30

Sorguyu çalıştırma

datatable(Name:string, d:dynamic)
[
    'James', dynamic({"Name": "John", "Age":20}),
    'David', dynamic({"Name": "Dave", "Age":40}),
    'Emily', dynamic({"Name": "Jasmine", "Age":30}),
]
| evaluate bag_unpack(d, columnsConflict='keep_source') // Keep old column Name

Çıktı

Name Age
James 20
Demirel 40
Emily 30

Bir torbayı ignoredProperties genişletin ve özellik paketindeki özelliklerden 2'sini yoksaymak için seçeneğini kullanın:

Sorguyu çalıştırma

datatable(d:dynamic)
[
    dynamic({"Name": "John", "Age":20, "Address": "Address-1" }),
    dynamic({"Name": "Dave", "Age":40, "Address": "Address-2"}),
    dynamic({"Name": "Jasmine", "Age":30, "Address": "Address-3"}),
]
// Ignore 'Age' and 'Address' properties
| evaluate bag_unpack(d, ignoredProperties=dynamic(['Address', 'Age']))

Çıktı

Name
John
Demirci
Yasemin

Bir torbayı genişletin ve OutputSchema seçeneğini kullanın:

Sorguyu çalıştırma

datatable(d:dynamic)
[
    dynamic({"Name": "John", "Age":20}),
    dynamic({ "Name": "Dave", "Height": 170, "Age":40}),
    dynamic({"Name": "Jasmine", "Age":30}),
]
| evaluate bag_unpack(d)

Çıktı

Age Height Name
20 John
40 170 Demirci
30 Yasemin

OutputSchema içeren bir torbayı genişletin ve joker * karakter seçeneğini kullanın:

Bu sorgu özgün yuva Açıklamasını ve OutputSchema'da tanımlanan sütunları döndürür.

Sorguyu çalıştırma

datatable(d:dynamic, Description: string)
[
    dynamic({"Name": "John", "Age":20, "height":180}), "Student",
    dynamic({"Name": "Dave", "Age":40, "height":160}), "Teacher",
    dynamic({"Name": "Jasmine", "Age":30, "height":172}), "Student",
]
| evaluate bag_unpack(d) : (*, Name:string, Age:long)

Çıktı

Açıklama Name Age
Öğrenci John 20
Öğretmen Demirci 40
Öğrenci Yasemin 30

Performans üzerindeki etkileri olan örnekler

Performans etkilerini karşılaştırmak için bir torbayı tanımlı OutputSchema ile ve olmadan genişletin:

Bu örnek , yardım kümesinde genel kullanıma açık bir tablo kullanır. ContosoSales veritabanında SalesDynamic adlı bir tablo vardır. Tablo satış verilerini içerir ve Customer_Properties adlı dinamik bir sütun içerir.

Müşteri özellikleri sütununun vurgulandığı SalesDynamic tablosunun ekran görüntüsü.

  • Çıkış şeması olmayan örnek: İlk sorgu OutputSchema tanımlamaz. Sorgu 5,84 saniye CPU alır ve 36,39 MB veri tarar.

    SalesDynamic
| evaluate bag_unpack(Customer_Properties) 
| summarize Sales=sum(SalesAmount) by Country, State

  • Çıkış şeması örneği: İkinci sorgu bir OutputSchema sağlar. Sorgu 0,45 saniye CPU alır ve 19,31 MB veri tarar. Sorgunun giriş tablosunu analiz etmek zorunda değildir ve işlem süresinden tasarruf edin.

    SalesDynamic
| evaluate bag_unpack(Customer_Properties) :  (*, Country:string, State:string, City:string)
| summarize Sales=sum(SalesAmount) by Country, State

Çıktı

Çıktı her iki sorgu için de aynıdır. Çıktının ilk 10 satırı aşağıda gösterilmiştir.

Country/Region State Sales
Kanada Britanya Kolumbiyası 56,101,083
Birleşik Krallık İngiltere 77,288,747
Avustralya Victoria 31,242,423
Avustralya Queensland 27,617,822
Avustralya Güney Avustralya 8,530,537
Avustralya Yeni Güney Galler 54,765,786
Avustralya Tazmanya 3,704,648
Kanada Alberta 375,061
Kanada Ontario 38,282
Amerika Birleşik Devletleri Washington 80,544,870
... ... ...

İlgili içerik

  • Last updated on