count_distinctif() (fonction d’agrégation) - (préversion)

  • Article

S’applique à : ✅Microsoft Fabric✅Azure Data Explorer✅Azure Monitor✅Microsoft Sentinel

Compte de manière conditionnelle des valeurs uniques spécifiées par l’expression scalaire par groupe de synthèse, ou le nombre total de valeurs uniques si le groupe de résumés est omis. Seuls les enregistrements pour lesquels le prédicat est évalué sont comptabilisés true .

Remarque

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

Si vous avez uniquement besoin d’une estimation du nombre de valeurs uniques, nous vous recommandons d’utiliser la fonction d’agrégation dcountif moins consommatrice de ressources.

Remarque

  • Cette fonction est limitée à 100M de valeurs uniques. Une tentative d’application de la fonction sur une expression retournant trop de valeurs génère une erreur d’exécution (HRESULT : 0x80DA0012).
  • Les performances des fonctions peuvent être détériorées lors de l’exploitation sur plusieurs sources de données provenant de différents clusters.
  • Les performances des fonctions peuvent être détériorées lors de l’exploitation sur plusieurs sources de données provenant de différents Eventhouses.

Syntaxe

count_distinctif(prédicat expr, )

En savoir plus sur les conventions de syntaxe.

Paramètres

Nom Type Requise Description
expr scalaire ✔️ Expression dont les valeurs uniques doivent être comptées.
prédicat string ✔️ Expression utilisée pour filtrer les enregistrements à agréger.

Retours

Valeur entière indiquant le nombre de valeurs uniques d’expr par groupe de synthèse, pour tous les enregistrements pour lesquels le prédicat est trueévalué .

Exemple

Cet exemple montre le nombre de types d’événements de tempête à l’origine de décès qui se sont produits dans chaque état. Seuls les événements de tempête avec un nombre différent de zéro de décès seront comptés.

Remarque

Les performances des fonctions peuvent être détériorées lors de l’exploitation sur plusieurs sources de données provenant de différents clusters.

Exécuter la requête

StormEvents
| summarize UniqueFatalEvents=count_distinctif(EventType,(DeathsDirect + DeathsIndirect)>0) by State
| where UniqueFatalEvents > 0
| top 5 by UniqueFatalEvents

Sortie

State UniqueFatalEvents
TEXAS 12
CALIFORNIE 12
OKLAHOMA 10
NEW YORK 9
KANSAS 9