A função COUNT_DISTINCT contabiliza o número de itens únicos em um campo.
Sintaxe
COUNT_DISTINCT(X)
Parâmetros
X: um campo ou uma expressão que contém os itens a serem contabilizados.
Como a função COUNT_DISTINCT funciona
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 resulte 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ática, 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 produz um erro porque Sessions é um campo agregado automaticamente.
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 "fazer pushdown") o cálculo de COUNT_DISTINCT para a 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 o seguinte:
- Bancos de dados SQL: diferentes dialetos SQL podem lidar com a diferenciação entre maiúsculas e minúsculas, a comparação de espaços à direita ou a contagem de valores nulos de maneiras exclusivas.
- Fontes 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 de nuvem e os conectores SaaS são limitados pelas capacidades da API, que podem retornar contagens aproximadas ou aplicar uma lógica de filtragem específica.