APPROXIMATEDISTINCTCOUNT

s’applique à :colonne calculéetable calculéemesurecalcul visuel

Retourne un estimation nombre de valeurs uniques dans une colonne.

Important

La prise en charge des APPROXIMATEDISTINCTCOUNT modes Import et Direct Lake Storage est actuellement en préversion.

Syntaxe

APPROXIMATEDISTINCTCOUNT(<columnName>)

Paramètres

Terme Description
column Colonne d’entrée.

L’argument column ne peut pas être une expression.

Valeur de retour

Nombre approximatif de valeurs distinctes dans column.

Remarques

  • Le seul argument de cette fonction est une colonne. Utilisez des colonnes contenant n’importe quel type de données. Lorsque la fonction ne trouve aucune ligne à compter, elle retourne un BLANK; sinon, elle retourne le nombre de valeurs distinctes.

  • En mode Importation, Direct Lake sur OneLake et Direct Lake sur SQL sans secours, la fonction utilise un algorithme HyperLogLog côté moteur.

  • En mode DirectQuery, la fonction appelle une opération d’agrégation correspondante dans la source de données. Ce comportement est pris en charge pour Azure SQL, Azure Synapse pool SQL dédié, BigQuery, Databricks et Snowflake. Direct Lake sur SQL utilise ce comportement DirectQuery lorsqu’il revient en mode DirectQuery.

  • Utilisez cette fonction pour les colonnes à cardinalité élevée lorsqu’un résultat approximatif est acceptable. Utilisez DISTINCTCOUNT quand vous avez besoin d’un résultat exact.

  • Pour les colonnes à faible cardinalité, APPROXIMATEDISTINCTCOUNT peut s’exécuter plus lentement que DISTINCTCOUNT. Il peut également utiliser plus de mémoire que DISTINCTCOUNT, en particulier avec des modèles volumineux, une concurrence élevée ou de nombreux groupes de groupes.

  • Le nombre estimé retourné par APPROXIMATEDISTINCTCOUNT un taux d’erreur d’environ 1,6% pour les modèles Import et Direct Lake.