count_distinct() (función de agregación): (versión preliminar)

Cuenta los valores únicos especificados por la expresión escalar por grupo de resumen o el número total de valores únicos si se omite el grupo de resumen.

Los valores NULL se omiten y no tienen en cuenta el cálculo.

Nota:

Esta función se usa junto con el operador summarize.

Si solo necesita una estimación del recuento de valores únicos, se recomienda usar la función de agregación menos consumida por dcount recursos.

Para contar solo los registros para los que un predicado devuelve true, use la función de agregación count_distinctif .

Nota:

• Esta función está limitada a 100 millones de valores únicos. Un intento de aplicar la función en una expresión que devuelve demasiados valores producirá un error en tiempo de ejecución (HRESULT: 0x80DA0012).
• El rendimiento de la función se puede degradar cuando se trabaja en varios orígenes de datos de diferentes clústeres.

Syntax

count_distinct(Expr)

Obtenga más información sobre las convenciones de sintaxis.

Parámetros

Nombre	Tipo	Requerido	Descripción
expr	escalar	✔️	Expresión cuyos valores únicos se van a contar.

Devoluciones

Valor entero largo que indica el número de valores únicos de expr por grupo de resumen.

Ejemplo

En este ejemplo se muestra cuántos tipos de eventos de tormenta se produjeron en cada estado.

Ejecución de la consulta

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

Salida

State	UniqueEvents
TEXAS	27
CALIFORNIA	26
PENSILVANIA	25
GEORGIA	24
CAROLINA DEL NORTE	23