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

Se aplica a: ✅Microsoft Fabric✅Azure Data Explorer✅Azure Monitor✅Microsoft Sentinel

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 100M 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 las funciones se puede degradar cuando se trabaja en varios orígenes de datos de diferentes instancias de Eventhouses.

Sintaxis

count_distinct(expr)

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

Parámetros

Nombre	Type	Obligatorio	Descripción
expr	escalares	✔️	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 storm se produjeron en cada estado.

Ejecute la consulta ::: moniker-end

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

Salida

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