Partage via


percentile_tdigest()

S’applique à : ✅Microsoft Fabric

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

Syntaxe

percentile_tdigest( expr,percentile1,typeLiteral)

En savoir plus sur les conventions de syntaxe.

Paramètres

Nom Type Requise Description
expr string ✔️ Expression générée par tdigest ou tdigest_merge().
Percentile real ✔️ Valeur qui spécifie le centile.
typeLiteral string Littéral de type. S’il est fourni, le jeu de résultats sera de ce type. Par exemple, typeof(long) caster tous les résultats en type long.

Retours

Valeur de centile de chaque valeur dans expr.

Conseil

  • Si le type a été fourni, le résultat est une colonne du même type fourni avec les résultats du centile. Dans ce cas, toutes les tdigest fonctions doivent être de ce type.
  • Si expr inclut tdigest des fonctions de différents types, ne fournissez pas le type. Le résultat sera de type dynamique. Consultez les exemples ci-dessous.

Exemples

Les exemples de cette section montrent comment utiliser la syntaxe pour vous aider à commencer.

Les exemples de cet article utilisent des tables disponibles publiquement dans le cluster d’aide, comme la table StormEvents dans la base de données Exemples.

Les exemples de cet article utilisent des tables disponibles publiquement, telles que la table StormEvents dans l’analyse météo exemples de données.

Nombre maximal de dommages par état

Cette requête vise à trouver le nombre maximal de dommages matériels causés par les événements de tempête dans chaque état.

StormEvents
| summarize tdigestRes = tdigest(DamageProperty) by State
| project percentile_tdigest(tdigestRes, 100)

Sortie

percentile_tdigest_tdigestRes
0
62000000
110000000
1200000
250 000

Durée maximale des dommages et heure de fin la plus récente par état

Cette requête vise à trouver le maximum de dommages matériels et l’heure de fin la plus récente des événements de tempête dans chaque état.

StormEvents
| summarize tdigestRes = tdigest(DamageProperty) by State
| union (StormEvents | summarize tdigestRes = tdigest(EndTime) by State)
| project percentile_tdigest(tdigestRes, 100)

Sortie

percentile_tdigest_tdigestRes
[0]
[62000000]
["2007-12-20T11:30:00.0000000Z"]
["2007-12-31T23:59:00.0000000Z"]