# Count - função de gráfico Count() é utilizada para agregar o número de valores, de texto e numérico em cada uma das dimensões de gráfico. Sintaxe: Count({[SetExpression] [DISTINCT] [TOTAL [<fld {,fld}>]]} expr) Tipo de dados de retorno: inteiro Argumentos | Argumento | Descrição | | --- | --- | | expr | A expressão ou campo que contém os dados a serem medidos. | | SetExpression | Por padrão, a função de agregação agregará um conjunto de registros possíveis definidos pela seleção. Um conjunto de registros alternativos pode ser definido por uma expressão de análise. | | DISTINCT | Se a palavra DISTINCT aparecer antes dos argumentos de função, as duplicatas resultantes da avaliação dos argumentos de função serão ignoradas. | | TOTAL | Se a palavra TOTAL ocorrer antes dos argumentos da função, o cálculo será feito sobre todos os valores possíveis, dadas as seleções atuais, e não apenas sobre os pertinentes ao valor dimensional atual, isto é, desconsiderando as dimensões do gráfico.

Usando TOTAL [<fld {.fld}>], em que o qualificador TOTAL é seguido por uma lista de um ou mais nomes de campo como um subconjunto das variáveis de dimensão de gráfico, você cria um subconjunto dos valores possíveis totais.

[Definindo o escopo de agregação](https://help.qlik.com/pt-BR/sense/November2025/Subsystems/Hub/Content/Sense_Hub/ChartFunctions/define-aggregation-scope.htm) | Exemplo: expressões de gráfico | Exemplo | Resultado | | --- | --- | | `Count(OrderNumber)` | Retorna o número de linhas que podem ter um valor para `OrderNumber`. Todos os registros, mesmo os vazios, são contados.

Nota informativa"0" conta como um valor, e não uma célula vazia. No entanto, se uma lista agregar ao 0 para uma dimensão, esta não será incluída nas tabelas. | | `Count(Customer)` | Avalia o número de ocorrências em todas as linhas. | | `Count(DISTINCT [Customer])` | O qualificador `DISTINCT` restringe a `Count` para avaliar apenas ocorrências únicas. | | `Count(OrderNumber)/Count({1} TOTAL OrderNumber)` | A expressão retorna o número de ordens do cliente selecionado como uma porcentagem das ordens de todos os clientes. | | `Count(TOTAL OrderNumber)` | Retorna o número de pedidos feitos em produtos somente para os clientes selecionados. As células vazias também são contadas. | ## Exemplo - Fundamentos de Count [](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/ChartFunctions/CounterAggregationFunctions/count.htm) #### Expressão de gráfico Visão geral Abra o editor da carga de dados e adicione o script de carregamento abaixo em uma nova seção. O script de carregamento contém: * Um conjunto de dados que é carregado em uma tabela de dados denominada `Example`. * Os campos a seguir na tabela de dados: * `Customer` * `Product` * `OrderNumber` * `UnitSales` * `UnitPrice` Script de carregamento ``` Example: LOAD * inline [ Customer|Product|OrderNumber|UnitSales|UnitPrice Astrida|AA|1|4|16 Astrida|AA|7|10|15 Astrida|BB|4|9|9 Betacab|CC|6|5|10 Betacab|AA|5|2|20 Betacab|BB|1|25| 25 Canutility|AA|3|8|15 Canutility|CC|||19 Divadip|CC|2|4|16 Divadip|DD|3|1|25 ](delimiter is '|'); ``` Resultados Carregue os dados e abra uma pasta. Crie uma nova tabela e adicione esse campo como uma dimensão: * `Customer` Crie as seguintes medidas: * `=Count(OrderNumber)` para contar o número de pedidos. * `=Count(Customer)` para calcular o número de registros de clientes. * `=Count(DISTINCT Customer)` para contar o número de clientes distintos. * `=Count(OrderNumber)/Count({1} TOTAL OrderNumber)` para contar a proporção dos pedidos de clientes selecionados como uma proporção do total de pedidos de clientes. * `=Count(TOTAL OrderNumber)` para contar o número de pedidos feitos de produtos somente para os clientes selecionados (células vazias são contadas). Results table | Customer | Count(OrderNumber) | Count(Customer) | Count(DISTINCT Customer) | Count(OrderNumber)/Count({1} TOTAL OrderNumber) | Count(TOTAL <Product> OrderNumber) | | --- | --- | --- | --- | --- | --- | | Totals | 10 | 10 | 4 | 1 | 10 | | Astrida | 3 | 3 | 1 | 0.3 | 10 | | Betacab | 3 | 3 | 1 | 0.3 | 10 | | Canutility | 2 | 2 | 1 | 0.2 | 10 | | Divadip | 2 | 2 | 1 | 0.2 | 10 | Analisando os resultados, podemos observar o seguinte: * Primeira medida: há `10` registros de pedidos no conjunto de dados. * Segunda medida: há `10` registros de clientes no conjunto de dados. * Terceira medida: há `4` clientes distintos (exclusivos) no conjunto de dados. * Quarta medida: retorna `1` porque nenhuma seleção foi aplicada. Se você selecionar o cliente `Canutility`, o valor mudará para `0.2` porque há `2` registros de pedidos para esse cliente de um total de `10` registros no conjunto de dados. * Quinta medida: retorna `10` porque nenhuma seleção foi aplicada. Se você selecionar os clientes `Astrida` e `Canutility`, o valor mudará para `5` porque esse é o número de pedidos feitos em produtos para esses clientes (células vazias também são contadas). ## Exemplo - Usando Count para encontrar o número de vendas por produto [](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/ChartFunctions/CounterAggregationFunctions/count.htm) #### Expressão de gráfico Visão geral Um conjunto de dados contém dados de vendas da loja. Você deseja descobrir o número de vendas por produto. Abra o editor da carga de dados e adicione o script de carregamento abaixo em uma nova seção. O script de carregamento contém: * Um conjunto de dados que é carregado em uma tabela de dados denominada `Example`. * Os campos a seguir na tabela de dados: * `Product` * `Sales` * `Region` * `Status` Script de carregamento ``` Example: Load * inline [ Product,Sales,Region,Status Apple, 100, North, Completed Banana, 80, South, Pending Carrot, 50, East, Completed Apple, 120, North, Completed Banana, 90, South, Completed Carrot, 60, West, Pending Apple, 110, North, Completed Banana, 85, South, Completed Carrot, 55, East, Pending ]; ``` Resultados Carregue os dados e abra uma pasta. Crie uma nova tabela e adicione esse campo como uma dimensão: * `Product` Crie as seguintes medidas: * `=Count(Sales)` para calcular o número de vendas por produto. * `=Count({} Sales)` para calcular o número de vendas com pedidos concluídos. * `=Count({} Sales)` para calcular o número de vendas com pedidos ainda pendentes. * `=Count({} Sales)` para calcular o número de pedidos na região `North`. Results table | Product | Count(Sales) | Count({<Status={'Completed'}>} Sales) | Count({<Status={'Pending'}>} Sales) | Count({<Region={'North'}>} Sales) | | --- | --- | --- | --- | --- | | Totals | 9 | 6 | 3 | 3 | | Apple | 3 | 3 | 0 | 3 | | Banana | 3 | 2 | 1 | 0 | | Carrot | 3 | 1 | 2 | 0 | A saída da função `Count` retorna uma decomposição do número total de pedidos de vendas por produto, além do número de pedidos concluídos e do número de pedidos ainda pendentes. A última medida retorna uma contagem de registros de vendas para a região `North`.