Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
A função COUNT_DISTINCT contabiliza o número de itens exclusivos 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 métrica, dimensão ou expressão de qualquer tipo. COUNT_DISTINCT retorna o número total de itens exclusivos nesse campo ou expressão.
Para contabilizar todos os itens, incluindo os duplicados, use COUNT.
Examples
Example formula
Output
COUNT_DISTINCT(user_id)
22.854.921
COUNT_DISTINCT(order_id)
497.091.812
Limites de COUNT_DISTINCT
Não é possível aplicar essa função a um campo pré-agregado ( tipo de agregaçãoAuto) ou a uma expressão resultante de outra função de agregação. Por exemplo, uma fórmula como COUNT_DISTINCT(Sessions) em uma fonte de dados do Google Analytics vai gerar um erro.
Para não incorrer em custos de consulta mais altos ao usar as fontes de dados do BigQuery, use APPROX_COUNT_DISTINCT.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Informações incorretas ou exemplo de código","incorrectInformationOrSampleCode","thumb-down"],["Não contém as informações/amostras de que eu preciso","missingTheInformationSamplesINeed","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-07-30 UTC."],[],[],null,["# COUNT_DISTINCT\n\nThe `COUNT_DISTINCT` function counts the number of unique items in a field.\n\nSyntax\n------\n\n`COUNT_DISTINCT( `\u003cvar translate=\"no\"\u003eX\u003c/var\u003e` )`\n\n### Parameters\n\n- \u003cvar translate=\"no\"\u003eX\u003c/var\u003e - a field or expression that contains the items to be counted.\n\nHow the `COUNT_DISTINCT` function works\n---------------------------------------\n\nThe `COUNT_DISTINCT` function takes 1 parameter, which can be the name of a metric, dimension, or expression of any type. `COUNT_DISTINCT` returns the total number of unique items in that field or expression.\n\nTo count all items, including duplicates, use `COUNT`.\n| **Tip:** There are 2 other ways to apply this function:\n|\n| \u003cbr /\u003e\n|\n| - In a data source, change a field's **Aggregation** type to `Count Distinct`.\n| - in a report, [edit the field's aggregation](/looker/docs/studio/edit-fields-in-your-reports) in a chart.\n\nExamples\n--------\n\nLimits of `COUNT_DISTINCT`\n--------------------------\n\nYou can't apply this function to a pre-aggregated field ( **Aggregation** type of **Auto** ), or to an expression which is the result of another aggregation function. For example, a formula such as `COUNT_DISTINCT(Sessions)` in a Google Analytics data source will produce an error.\n\nTo avoid possibly incurring higher query costs when using BigQuery data sources, consider using `APPROX_COUNT_DISTINCT`.\n\nRelated resources\n-----------------\n\n- [Calculated fields](/looker/docs/studio/about-calculated-fields)\n- [Looker Studio function list](/looker/docs/studio/function-list)"]]
