Partager via


percentile_array_tdigest()

S’applique à : ✅Microsoft Fabric✅Azure Data ExplorerAzure MonitorMicrosoft Sentinel

Calcule le résultat du centile à partir des tdigest résultats (générés par tdigest() ou tdigest_merge())

Syntaxe

percentiles_array_tdigest(tdigest, percentile1 [, centile2, ...])

percentiles_array_tdigest(tdigest, Dynamic array [, typeLiteral ])

En savoir plus sur les conventions de syntaxe.

Paramètres

Nom Type Requise Description
tdigest string ✔️ Résultats tdigest ou tdigest_merge() utilisés pour calculer les centiles.
Percentile real ✔️ Liste de valeurs séparées par des virgules ou des valeurs qui spécifient les centiles.
Tableau dynamique dynamic ✔️ Tableau dynamique de nombres réels qui spécifient les centiles.
typeLiteral string Littéral de type. Par exemple : typeof(long). S’il est fourni, le jeu de résultats est de ce type.

Retours

Valeur centile/centile de chaque valeur en tdigest.

Conseil

  • La fonction doit recevoir au moins un pourcentage (et peut-être plus, voir la syntaxe ci-dessus : percentile1 [, centile2] ... [, percentileN]) et le résultat est un tableau dynamique qui inclut les résultats. (comme percentiles())
  • Si un seul pourcentage a été fourni et que le type a également été fourni, le résultat sera une colonne du même type fourni avec les résultats de ce pourcentage. Dans ce cas, toutes les tdigest fonctions doivent être de ce type.
  • Si vous n’avez pas besoin de ingérer des tdigest fonctions de différents types, ne fournissez pas le type. Le résultat sera de type dynamique. Consultez les exemples ci-dessous.

Exemples

StormEvents
| summarize tdigestRes = tdigest(DamageProperty) by State
| project percentiles_array_tdigest(tdigestRes, range(0, 100, 50), typeof(int))

Sortie

percentile_tdigest_tdigestRes
[0,0,0]
[0,0,62000000]
[0,0,110000000]
[0,0,1200000]
[0,0,250000]