Partager via


hll_if() (fonction d’agrégation)

S’applique à : ✅Microsoft Fabric

Calcule les résultats intermédiaires des dcount enregistrements pour lesquels le prédicat est évalué trueà .

En savoir plus sur l’algorithme sous-jacent (HyperLogog) et la précision de l’estimation.

Remarque

Cette fonction est utilisée conjointement avec l’opérateur de synthèse.

Syntaxe

hll_if ( expr, prédicat [,précision])

En savoir plus sur les conventions de syntaxe.

Paramètres

Nom Type Requise Description
expr string ✔️ Expression utilisée pour le calcul d’agrégation.
prédicat string ✔️ Expr utilisé pour filtrer les enregistrements à ajouter au résultat intermédiaire de dcount.
exactitude int Valeur qui contrôle l’équilibre entre vitesse et précision. Si la valeur n’est pas spécifiée, la valeur par défaut est 1. Pour connaître les valeurs prises en charge, consultez La précision de l’estimation.

Retours

Retourne les résultats intermédiaires du nombre distinct d’Expr pour lequel le prédicat est trueévalué .

Remarque

  • Les résultats de hll(), de hll_if() et de hll_merge() peuvent être stockés et récupérés ultérieurement. Par exemple, vous pouvez créer un résumé d’utilisateur unique quotidien, qui peut ensuite être utilisé pour calculer les nombres hebdomadaires. Toutefois, la représentation binaire précise de ces résultats peut changer au fil du temps. Il n’existe aucune garantie que ces fonctions produisent des résultats identiques pour les entrées identiques, et par conséquent, nous ne conseillons pas de s’appuyer sur eux.
  • Utilisez la fonction hll_merge pour fusionner plusieurs hll résultat intermédiaire. Fonctionne uniquement avec hll sortie.
  • Utilisez dcount_hll, pour calculer le nombre distinct de hll,hll_mergeou hll_if fonctions d’agrégation.

Exemples

La requête suivante entraîne le nombre de sources d’événements d’inondation uniques dans l’Iowa et le Kansas. Elle utilise la fonction hll_if() pour afficher uniquement les événements d’inondation.

StormEvents
| where State in ("IOWA", "KANSAS")
| summarize hll_flood = hll_if(Source, EventType == "Flood") by State
| project State, SourcesOfFloodEvents = dcount_hll(hll_flood)

de sortie

État SourcesOfFloodEvents
KANSAS 11
IOWA 7

Exactitude d’estimation

Précision Vitesse Erreur (%)
0 Le plus rapide 1.6
1 Équilibrée 0,8
2 Lente 0.4
3 Lente 0,28
4 Le plus lent 0.2