# NullCount - função de gráfico NullCount() é utilizada para agregar o número de valores null em cada dimensão de gráfico. Sintaxe: NullCount({[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 | | --- | --- | | `NullCount(OrderNumber)` | Retorna a contagem de valores nulos no campo `OrderNumber`. | | ` NullCount (OrderNumber)/NullCount ({1} Total OrderNumber) ` | A expressão retorna o número de pedidos com `NULL` como o `OrderNumber` do cliente selecionado como uma fração de todos os pedidos de clientes com `NULL` como o `OrderNumber`. | ## Exemplo - Fundamentos de NullCount [](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/ChartFunctions/CounterAggregationFunctions/nullcount.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`. * A variável de manipulação de valor `NullInterpret` que está definida como `NULL`. A variável interpretará todos os registros com o texto `NULL` como valores nulos. * Os campos a seguir na tabela de dados: * `Customer` * `Product` * `OrderNumber` Script de carregamento ``` Set NULLINTERPRET = NULL; Example: LOAD * inline [ Customer|Product|OrderNumber Astrida|AA|1 Astrida|AA|7 Astrida|BB|4 Astrida|CC|6 Betacab|AA|5 Betacab|BB|2 Betacab|DD|NULL Canutility|AA|3 Canutility|AA|NULL Canutility|CC|NULL ] (delimiter is '|'); ``` Nota de dicaPara definir a variável `NullInterpret` de volta ao padrão, inclua a instrução de variável a seguir no final do script de carregamento: `Set NULLINTERPRET =;` 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: * `=NullCount(OrderNumber)` para calcular o número de pedidos que têm `NULL` como um `OrderNumber`. * `=NullCount (OrderNumber)/NullCount ({1} Total OrderNumber)` para retornar o número de pedidos (do cliente selecionado) com `NULL` como um `OrderNumber` como uma fração de todos os pedidos de clientes com `NULL` como o `OrderNumber`. Para mostrar esse valor como uma porcentagem, em Formatação de números, selecione Número > Formatação simples > 12,34%. Results table | Customer | NullCount(OrderNumber) | NullCount (OrderNumber)/NullCount ({1} Total OrderNumber) | | --- | --- | --- | | Totals | 3 | 100.00% | | Astrida | 0 | 0.00% | | Betacab | 1 | 33.33% | | Canutility | 2 | 66.67% | A primeira medida retorna `3` porque há um total de `3` registros `OrderNumber` com um valor `NULL` (registro `1` com o cliente `Betacab` e registros `2` com `Canutility`). A segunda medida retorna o número de pedidos `NULL` como uma fração de pedidos `NULL` de todos os clientes. Por exemplo, `66.67%` de todos os números de pedidos com um valor `NULL` são atribuídos ao cliente `Canutility`. ## Exemplo - Usando NullCount para identificar valores nulos em dados de KPI [](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/ChartFunctions/CounterAggregationFunctions/nullcount.htm) #### Expressão de gráfico Visão geral Um conjunto de dados contém dados mensais de indicadores-chave de produtos (KPI). Um gerente de produto quer descobrir quais KPIs têm valores nulos nos dados. 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`. * A variável de manipulação de valor `NullInterpret` que está definida como `NULL`. A variável interpretará todos os registros com o texto `NULL` como valores nulos. * Os campos a seguir na tabela de dados: * `Month` * `KPI` * `Value` Script de carregamento ``` Set NULLINTERPRET = NULL; Example: LOAD * inline [ Month, KPI, Value 2024-01-01, Revenue, 5000 2024-02-01, Revenue, NULL 2024-03-01, Revenue, 5500 2024-04-01, Revenue, NULL 2024-01-01, Expenses, 3000 2024-02-01, Expenses, 3100 2024-03-01, Expenses, NULL 2024-04-01, Expenses, 3200 2024-01-01,Customer Count, 200 2024-02-01,Customer Count, 210 2024-03-01,Customer Count, NULL 2024-04-01,Customer Count, NULL ]; ``` Nota de dicaPara definir a variável `NullInterpret` de volta ao padrão, inclua a instrução de variável a seguir no final do script de carregamento: `Set NULLINTERPRET =;` Resultados Carregue os dados e abra uma pasta. Crie uma nova tabela dinâmica e adicione esse campo como uma dimensão de linha: * `KPI` Crie a seguinte medida: * `=NullCount(Value)` para calcular o número de valores ausentes. Results table | KPI | NullCount(Value) | | --- | --- | | Customer Count | 2 | | Expenses | 1 | | Revenue | 2 | Os resultados mostram que `5` registros no conjunto de dados possuem valores `NULL` e as categorias de KPI às quais esses registros se relacionam.