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

Compte les 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.

Les valeurs Null sont ignorées et ne sont pas prises en compte dans le calcul.

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 moins consommatrice dcount de ressources.

Pour compter uniquement les enregistrements pour lesquels un prédicat retourne true, utilisez la fonction d’agrégation count_distinctif.

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_distinct(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.

Retours

Valeur entière longue indiquant le nombre de valeurs uniques d’expr par groupe récapitulative.

Exemple

Cet exemple montre le nombre de types d’événements storm qui se sont produits dans chaque état.

Exécuter la requête

StormEvents
| summarize UniqueEvents=count_distinct(EventType) by State
| top 5 by UniqueEvents

Sortie

State	UniqueEvents
TEXAS	27
CALIFORNIE	26
PENNSYLVANIA	25
GEORGIE	24
CAROLINE DU NORD	23