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

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

Cuenta condicionalmente 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. Solo se cuentan los registros para los que se evalúa true el predicado.

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 dcountif que consume menos recursos.

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_distinctif(predicado 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.
predicado	string	✔️	Expresión que se usa para filtrar los registros que se van a agregar.

Devoluciones

Valor entero que indica el número de valores únicos de expr por grupo de resumen, para todos los registros para los que el predicado se evalúa como true.

Ejemplo

En este ejemplo se muestra cuántos tipos de eventos de tormenta de causa de muerte se produjeron en cada estado. Solo se contarán los eventos de tormenta con un recuento distinto de cero de muertes.

StormEvents
| summarize UniqueFatalEvents=count_distinctif(EventType,(DeathsDirect + DeathsIndirect)>0) by State
| where UniqueFatalEvents > 0
| top 5 by UniqueFatalEvents

Salida

Valor	UniqueFatalEvents
TEXAS	12
CALIFORNIA	12
OKLAHOMA	10
NUEVA YORK	9
KANSAS	9