Udostępnij za pośrednictwem

percentiles_linear_fl()

Dotyczy: ✅Microsoft Fabric✅Azure Data Explorer

Funkcja percentiles_linear_fl() jest funkcją zdefiniowaną przez użytkownika (UDF), która oblicza percentyle przy użyciu interpolacji liniowej między najbliższymi szeregami, tą samą metodą używaną przez PERCENTILES programu Excel . INC , funkcja. Natywne funkcje percentyla kusto używają najbliższej metody rangi. W przypadku dużych zestawów wartości różnica między obiema metodami jest nieistotna i zalecamy użycie funkcji natywnej w celu uzyskania najlepszej wydajności. Aby uzyskać więcej informacji na temat tych i dodatkowych metod obliczeń percentylu, zapoznaj się z artykułem percentylowym w Wikipedii. Funkcja akceptuje tabelę zawierającą kolumnę do obliczenia i opcjonalny klucz grupowania oraz tablicę dynamiczną wymaganych percentyli i zwraca kolumnę zawierającą tablicę dynamiczną wartości percentyli na każdą grupę.

Składnia

T | invoke percentiles_linear_fl(, val_col pct_arr [, aggr_col ])

Dowiedz się więcej na temat konwencji składni.

Parametry

Nazwisko Type Wymagania opis
val_col string ✔️ Nazwa kolumny zawierającej wartości, za pomocą których mają być obliczane percentyle.
pct_arr dynamic ✔️ Tablica liczbowa zawierająca wymagane percentyle. Każdy percentyl powinien znajdować się w zakresie [0–100].
aggr_col string Nazwa kolumny zawierającej klucz grupowania.

Definicja funkcji

Funkcję można zdefiniować, osadzając jej kod jako funkcję zdefiniowaną przez zapytanie lub tworząc ją jako funkcję przechowywaną w bazie danych w następujący sposób:

Zdefiniuj funkcję przy użyciu następującej instrukcji let. Nie są wymagane żadne uprawnienia.

Ważne

Instrukcja let nie może działać samodzielnie. Należy po nim wykonać instrukcję wyrażenia tabelarycznego. Aby uruchomić działający przykład polecenia percentiles_linear_fl(), zobacz Przykład.

let percentiles_linear_fl=(tbl:(*), val_col:string, pct_arr:dynamic, aggr_col:string='')
{
    tbl
    | extend _vals = column_ifexists(val_col, 0.0)
    | extend _key = column_ifexists(aggr_col, 'ALL')
    | order by _key asc, _vals asc 
    | summarize _vals=make_list(_vals) by _key
    | extend n = array_length(_vals)
    | extend pct=pct_arr
    | mv-apply pct to typeof(real) on (
          extend index=pct/100.0*(n-1)
        | extend low_index=tolong(floor(index, 1)), high_index=tolong(ceiling(index))
        | extend interval=todouble(_vals[high_index])-todouble(_vals[low_index])
        | extend pct_val=todouble(_vals[low_index])+(index-low_index)*interval
        | summarize pct_arr=make_list(pct), pct_val=make_list(pct_val))
    | project-away n
};
// Write your query to use the function here.

Przykład

W poniższym przykładzie użyto operatora invoke do uruchomienia funkcji.

Aby użyć funkcji zdefiniowanej przez zapytanie, wywołaj ją po definicji funkcji osadzonej.

let percentiles_linear_fl=(tbl:(*), val_col:string, pct_arr:dynamic, aggr_col:string='')
{
    tbl
    | extend _vals = column_ifexists(val_col, 0.0)
    | extend _key = column_ifexists(aggr_col, 'ALL')
    | order by _key asc, _vals asc 
    | summarize _vals=make_list(_vals) by _key
    | extend n = array_length(_vals)
    | extend pct=pct_arr
    | mv-apply pct to typeof(real) on (
          extend index=pct/100.0*(n-1)
        | extend low_index=tolong(floor(index, 1)), high_index=tolong(ceiling(index))
        | extend interval=todouble(_vals[high_index])-todouble(_vals[low_index])
        | extend pct_val=todouble(_vals[low_index])+(index-low_index)*interval
        | summarize pct_arr=make_list(pct), pct_val=make_list(pct_val))
    | project-away n
};
datatable(x:long, name:string) [
5, 'A',
9, 'A',
7, 'A',
5, 'B',
7, 'B',
7, 'B',
10, 'B',
]
| invoke percentiles_linear_fl('x', dynamic([0, 25, 50, 75, 100]), 'name')
| project-rename name=_key, x=_vals

Wyjście

name x pct_arr pct_val
A [5,7,9] [0,25,50,75,100] [5,6,7,8,9]
B [5,7,7,10] [0,25,50,75,100] [5,6.5,7,7.75,10]