basket, wtyczka
Dotyczy: ✅Microsoft Fabric✅Azure Data Explorer
Wtyczka basket znajduje częste wzorce atrybutów w danych i zwraca wzorce, które przechodzą próg częstotliwości w tych danych. Wzorzec reprezentuje podzbiór wierszy, które mają tę samą wartość w co najmniej jednej kolumnie. Wtyczka basket jest oparta na algorytmie Apriori pierwotnie opracowanym na potrzeby wyszukiwania danych analizy koszyka.
Składnia
T(evaluate | basket [ Weight WeightColumn, , MaxDimensions, CustomWildcard CustomWildcard, , ... ])
Dowiedz się więcej na temat konwencji składni.
Parametry
| Nazwisko | Type | Wymagania | opis |
|---|---|---|---|
| Threshold | long |
Wartość double w zakresie od 0,015 do 1, która określa minimalny współczynnik wierszy, które mają być brane pod uwagę jako częste. Wzorce o mniejszym współczynniku nie zostaną zwrócone. Wartość domyślna to 0,05. Aby użyć wartości domyślnej, wprowadź tyldę: ~.Przykład: T | evaluate basket(0.02) |
|
| Kolumna wagowa | string |
Nazwa kolumny, która ma być używana do rozważenia każdego wiersza w danych wejściowych zgodnie z określoną wagą. Musi być nazwą kolumny typu liczbowego, takiej jak int, long, real. Domyślnie każdy wiersz ma wagę 1. Aby użyć wartości domyślnej, wprowadź tyldę: ~. Typowym zastosowaniem kolumny wagi jest uwzględnienie próbkowania lub zasobnika/agregacji danych, które są już osadzone w każdym wierszu.Przykład: T | evaluate basket('~', sample_Count) |
|
| MaxDimensions | int |
Ustawia maksymalną liczbę wymiarów niekorrelowanych na koszyk, ograniczony domyślnie, aby zminimalizować środowisko uruchomieniowe zapytania. Ustawieniem domyślnym jest 5. Aby użyć wartości domyślnej, wprowadź tyldę: ~.Przykład: T | evaluate basket('~', '~', 3) |
|
| CustomWildcard | string |
Ustawia wartość symboli wieloznacznych dla określonego typu w tabeli wyników, która będzie wskazywać, że bieżący wzorzec nie ma ograniczenia dla tej kolumny. Wartość domyślna jest null wyjątkiem kolumn ciągów, których wartość domyślna jest pustym ciągiem. Jeśli wartość domyślna jest dobrą wartością w danych, należy użyć innej wartości wieloznacznych, takiej jak *. Aby użyć wartości domyślnej, wprowadź tyldę: ~.Przykład: T | evaluate basket('~', '~', '~', '*', int(-1), double(-1), long(0), datetime(1900-1-1)) |
Uwaga
Aby określić opcjonalny parametr, który jest zgodny z opcjonalnym parametrem, upewnij się, że podano wartość poprzedniego opcjonalnego parametru. Aby uzyskać więcej informacji, zobacz Praca z parametrami opcjonalnymi.
Zwraca
Wtyczka basket zwraca częste wzorce, które przechodzą próg współczynnika. Domyślny próg to 0,05.
Każdy wzorzec jest reprezentowany przez wiersz w wynikach. Pierwsza kolumna to identyfikator segmentu. Następne dwie kolumny to liczba i procent wierszy z oryginalnego zapytania zgodnego ze wzorcem. Pozostałe kolumny odnoszą się do oryginalnego zapytania z określoną wartością z kolumny lub wartości wieloznacznych, która jest domyślnie równa null, co oznacza wartość zmiennej.
Uwaga
Algorytm używa próbkowania do określania początkowych częstych wartości. W związku z tym wyniki mogą nieznacznie różnić się między wieloma przebiegami dla wzorców, których częstotliwość jest bliska progu.
Przykład
StormEvents
| where monthofyear(StartTime) == 5
| extend Damage = iff(DamageCrops + DamageProperty > 0 , "YES" , "NO")
| project State, EventType, Damage, DamageCrops
| evaluate basket(0.2)
Wyjście
| Identyfikator segmentu | Count | Procent | Stan | EventType | Uszkodzenia | DamageCrops |
|---|---|---|---|---|---|---|
| 0 | 4574 | 77.7 | NIE | 0 | ||
| 1 | 2278 | 38.7 | Grad | NIE | 0 | |
| 2 | 5675 | 96,4 | 0 | |||
| 3 | 2371 | 40.3 | Grad | 0 | ||
| 100 | 1279 | 21.7 | Wiatr i burza | 0 | ||
| 5 | 2468 | 41.9 | Grad | |||
| 6 | 1310 | 22,3 | TAK | |||
| 7 | 1291 | 21.9 | Wiatr i burza |
Przykład z niestandardowymi symbolami wieloznacznymi
StormEvents
| where monthofyear(StartTime) == 5
| extend Damage = iff(DamageCrops + DamageProperty > 0 , "YES" , "NO")
| project State, EventType, Damage, DamageCrops
| evaluate basket(0.2, '~', '~', '*', int(-1))
Wyjście
| Identyfikator segmentu | Count | Procent | Stan | EventType | Uszkodzenia | DamageCrops |
|---|---|---|---|---|---|---|
| 0 | 4574 | 77.7 | * | * | NIE | 0 |
| 1 | 2278 | 38.7 | * | Grad | NIE | 0 |
| 2 | 5675 | 96,4 | * | * | * | 0 |
| 3 | 2371 | 40.3 | * | Grad | * | 0 |
| 100 | 1279 | 21.7 | * | Wiatr i burza | * | 0 |
| 5 | 2468 | 41.9 | * | Grad | * | -1 |
| 6 | 1310 | 22,3 | * | * | TAK | -1 |
| 7 | 1291 | 21.9 | * | Wiatr i burza | * | -1 |