Compartir a través de


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

Se aplica a: ✅Microsoft FabricAzure Data Explorer✅Azure MonitorMicrosoft 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 distintos clústeres.
  • 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.

El rendimiento de las funciones se puede degradar cuando se trabaja en varios orígenes de datos de distintos clústeres.

Ejecutar el de consulta

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