A função Null retorna um valor null.
Sintaxe:
Null( )
Tipo de dados de retorno: NULL
| 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
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.
| 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.
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 valoresNULL são representados por -.
| ID | Value | ValueNullConv | IsItNull |
|---|---|---|---|
| 0 | - | T | |
| 1 | NULL | - | T |
| 2 | - | - | T |
| 3 | 386 | 386 | F |
Exemplo - Excluindo valores usando Null
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.
| 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.