# NULLFunção de script e de gráfico

A função Null retorna um valor null.

Sintaxe:

Null( )

Tipo de dados de retorno: NULL

Exemplo: expressões de gráfico

| Exemplo | Resultado |
| --- | --- |
| `If(Product = 'A', Null(),Sum(Sales))` | Essa expressão retorna `NULL` para `Product A`, caso contrário, retorna a soma das vendas do produto. |

## Exemplo - Fundamentos de Null

[](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/NULLFunctions/Null.htm)

#### Expressão de gráfico

Visão geral

Um conjunto de dados simples é usado para demonstrar os diferentes usos da função `Null`.

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:

  * `ID`

  * `Value`

Script de carregamento

```
Example:
LOAD * Inline
[ID, Value
0,
1,NULL
2,-
3,378];
```

Resultados

Carregue os dados e abra uma pasta. Crie uma nova tabela e adicione esses campos como dimensões:

* `ID`

* `Value`

Crie as seguintes dimensões calculadas:

* `=If(len(trim(Value))= 0 or Value='NULL' or Value='-', Null(), Value )` para retornar `NULL` se o campo `Value` tiver qualquer um dos seguintes: nenhum valor, um caractere de traço (-) ou o valor `NULL`, caso contrário, ele retorna o valor.

* `=If(IsNull(If(len(trim(Value))= 0 or Value='NULL' or Value='-', Null(), Value )), 'T', 'F')` para retornar o valor `T` (true) ou `F` (false) dependendo se o campo `Value` contém um valor nulo ou não.

Results table

| ID | Value | If(len(trim(Value))= 0 or Value='NULL' or Value='-', Null(), Value ) | If(IsNull(If(len(trim(Value))= 0 or Value='NULL' or Value='-', Null(), Value )), 'T', 'F') |
| --- | --- | --- | --- |
| 0 |  | - | T |
| 1 | NULL | - | T |
| 2 | - | - | T |
| 3 | 378 | 378 | F |

A coluna `Value` mostra os dados conforme inseridos no conjunto de dados. A primeira medida (coluna 3) utiliza a função `Null` para retornar `NULL` para aqueles valores que atenderam às condições da instrução `IF`: `len(trim(Value))= 0 or Value='NULL' or Value='-'`. Por exemplo, as 3 primeiras linhas atenderam aos requisitos e retornaram `NULL`. A última linha retorna o valor conforme inserido, `378`.

A segunda medida (coluna 4) pega o valor da coluna 3 e retorna `T` se `NULL` ou `F` se não `NULL`. Os resultados mostram que as 3 primeiras linhas são valores nulos.

[](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/NULLFunctions/Null.htm)

#### Script de carregamento

Neste exemplo, uma tabela embutida com quatro linhas é carregada, onde as três primeiras linhas não contêm nada, um traço - ou o texto NULL da coluna `Value`. Convertemos esses valores em representações de valor NULL verdadeiras.

O LOAD precedente intermediário realiza a conversão usando a função `Null`.

O primeiro LOAD precedente adiciona um campo que verifica se o valor é NULL, com o objetivo de ilustração neste exemplo.

```
NullsDetectedAndConverted:
LOAD *,
If(IsNull(ValueNullConv), 'T', 'F') as IsItNull;

LOAD *,
If(len(trim(Value))= 0 or Value='NULL' or Value='-', Null(), Value ) as ValueNullConv;

LOAD * Inline
[ID, Value
0,
1,NULL
2,-
3, 386];
```

Abaixo está a tabela resultante. Na coluna `ValueNullConv`, os valores`NULL` são representados por `-`.

Results table

| ID | Value | ValueNullConv | IsItNull |
| --- | --- | --- | --- |
| 0 |  | - | T |
| 1 | NULL | - | T |
| 2 | - | - | T |
| 3 | 386 | 386 | F |

## Exemplo - Excluindo valores usando Null

[](https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/NULLFunctions/Null.htm)

#### Expressão de gráfico

Visão geral

Os dados de vendas são analisados para determinar o total de vendas e as vendas que não estão relacionadas ao `Product A`.

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`

Script de carregamento

```
Example:
LOAD * Inline [
Product, Sales
A, 100
B, 150
C, 200
D, 250
];
```

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:

* `=Sum(Sales)` para calcular o total de vendas.

* `=If(Product = 'A', Null(),Sum(Sales))` para calcular o total de vendas em que o `Product` não é `A`.

Results table

| Product | Sum(Sales) | If(Product = 'A', Null(),Sum(Sales)) |
| --- | --- | --- |
| A | 100 | - |
| B | 150 | 150 |
| C | 200 | 200 |
| D | 250 | 250 |

Este exemplo mostra uma maneira simples de calcular o total de vendas e, em seguida, excluir as vendas de um produto específico usando a função `Null` para definir o valor como `NULL`. Por exemplo, na segunda medida, todos os valores para `Product A` retornaram `NULL` e foram excluídos.