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

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.

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.

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