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.