COUNT_DISTINCT

A função COUNT_DISTINCT contabiliza o número de itens únicos em um campo.

Sintaxe

COUNT_DISTINCT(X)

Parâmetros

  • X: campo ou expressão que contém os itens a serem contabilizados.

Sobre a função COUNT_DISTINCT

A função COUNT_DISTINCT usa um parâmetro, que pode ser o nome de uma dimensão ou uma expressão que não resulta em uma agregação. COUNT_DISTINCT retorna o número total de itens únicos nesse campo ou expressão.

Para contabilizar todos os itens, incluindo os duplicados, use COUNT.

Exemplos

Example formula Output
COUNT_DISTINCT(user_id) 22.854.921
COUNT_DISTINCT(order_id) 497.091.812

Limites de COUNT_DISTINCT

Ao usar a função COUNT_DISTINCT, observe o seguinte:

COUNT_DISTINCT funciona com dados não agregados

Não é possível aplicar essa função a métricas, incluindo campos com um tipo de Agregação Automático, ou a uma expressão que seja o resultado de outra função de agregação. Por exemplo, uma fórmula como COUNT_DISTINCT(Sessions) em uma fonte de dados do Google Analytics gera um erro porque Sessions é um campo agregado automático.

Considere usar APPROX_COUNT_DISTINCT para dados do BigQuery

Para não incorrer em custos de consulta mais altos ao usar as fontes de dados do BigQuery, utilize APPROX_COUNT_DISTINCT.

Resultados variáveis do pushdown de função

Para otimizar a performance, o Data Studio tenta delegar (ou "enviar") o cálculo de COUNT_DISTINCT à fonte de dados subjacente sempre que possível. Como a contagem real é realizada pelo sistema conectado, e não pelo Data Studio, os resultados podem variar dependendo de como esse sistema implementa a contagem distinta.

Por exemplo, os fatores que podem levar a diferenças nas contagens distintas incluem:

  • Bancos de dados SQL: diferentes dialetos SQL podem lidar com diferenciação de maiúsculas e minúsculas, comparação de espaços à direita ou contagem de valores nulos de maneiras exclusivas.
  • Origens baseadas em arquivos: para conectores de arquivos (como arquivos CSV), os resultados dependem do comportamento de análise do site de destino e das operações internas do mecanismo.
  • APIs SaaS: os serviços em nuvem e os conectores SaaS são limitados pelos recursos da API, que podem retornar contagens aproximadas ou aplicar uma lógica de filtragem específica.