Valores nulos

Todos os tipos de dados escalares no Kusto têm um valor especial que representa um valor ausente. Esse valor é chamado de valor nulo ou nulo.

Observação

O string tipo de dados não dá suporte a valores nulos.

Literais nulos

O valor nulo de um tipo escalar T é representado na linguagem de consulta pelo literal T(null)nulo .

A consulta a seguir retorna uma única linha cheia de valores nulos:

Executar a consulta

print bool(null), datetime(null), dynamic(null), guid(null), int(null), long(null), real(null), double(null), timespan(null)

Predicados em valores nulos

A função isnull() escalar pode ser usada para determinar se um valor escalar é o valor nulo. A função isnotnull() correspondente pode ser usada para determinar se um valor escalar não é o valor nulo.

Observação

Como o string tipo não dá suporte a valores nulos, recomendamos usar as isempty()isnotempty() funções e .

Igualdade e desigualdade de valores nulos

• Igualdade (==): aplicar o operador de igualdade a dois valores nulos gera bool(null). Aplicar o operador de igualdade a um valor nulo e um valor não nulo gera bool(false).
• Desigualdade (!=): aplicar o operador de desigualdade a dois valores nulos gera bool(null). Aplicar o operador de desigualdade a um valor nulo e um valor não nulo gera bool(true).

Por exemplo:

Executar a consulta

datatable(val:int)[5, int(null)]
| extend IsBiggerThan3 = val > 3
| extend IsBiggerThan3OrNull = val > 3 or isnull(val)
| extend IsEqualToNull = val == int(null)
| extend IsNotEqualToNull = val != int(null)

Saída

Val	IsBiggerThan3	IsBiggerThan3OrNull	IsEqualToNull	IsNotEqualToNull
5	true	true	false	true
null	null	true	null	null

Valores nulos e funções de agregação

Ao aplicar os seguintes operadores a entidades que incluem valores nulos, os valores nulos são ignorados e não levam em conta o cálculo:

• count()
• count_distinct()
• countif()
• dcount()
• dcountif()
• make_bag()
• make_bag_if()
• make_list()
• make_list_if()
• make_set()
• make_set_if()
• stdev()
• stdevif()
• sum()
• sumif()
• variance()
• varianceif()

Valores nulos e o where operador

O operador where usa expressões boolianas para determinar se deve emitir cada registro de entrada para a saída. Esse operador trata valores nulos como se fossem bool(false). Registros para os quais o predicado retorna o valor nulo são descartados e não aparecem na saída.

Por exemplo:

Executar a consulta

datatable(ival:int, sval:string)[5, "a", int(null), "b"]
| where ival != 5

Saída

ival	sval
null	b

Valores nulos e operadores binários

Os operadores binários são operadores escalares que aceitam dois valores escalares e produzem um terceiro valor. Por exemplo, maiores que (>) e AND boolianos (&&) são operadores binários.

Para todos os operadores binários, exceto conforme observado em Exceções a essa regra, a regra é a seguinte:

Se um ou ambos os valores de entrada para o operador binário forem valores nulos, a saída do operador binário também será o valor nulo. Em outras palavras, o valor nulo é "sticky".

Exceções a essa regra

• Para os operadores de igualdade (==) e desigualdade (!=), se um dos valores for nulo e o outro valor não for nulo, o resultado será bool(false) ou bool(true), respectivamente.
• Para o operador AND lógico (&&), se um dos valores for bool(false), o resultado também bool(false)será .
• Para o operador OR lógico (||), se um dos valores for bool(true), o resultado também bool(true)será .

Por exemplo:

Executar a consulta

datatable(val:int)[5, int(null)]
| extend Add = val + 10
| extend Multiply = val * 10

Saída

Val	Adicionar	Multiplicar
5	15	50
null	null	null

Valores nulos e o operador NOT lógico (!)

O operador NOT lógico not() produzirá o valor bool(null) se o argumento for o valor nulo.

Valores nulos e o in operador

• O operador in se comporta como um OR lógico de comparações de igualdade.
• O !in operador se comporta como uma lógica AND de comparações de desigualdade.

Valores nulos e ingestão de dados

Para a maioria dos tipos de dados, um valor ausente na fonte de dados produz um valor nulo na célula de tabela correspondente. No entanto, colunas do tipo string e formatos de dados CSV (ou semelhantes a CSV) são uma exceção a essa regra e um valor ausente produz uma cadeia de caracteres vazia.

Por exemplo:

.create table T(a:string, b:int)

.ingest inline into table T
[,]
[ , ]
[a,1]

T
| project a, b, isnull_a=isnull(a), isempty_a=isempty(a), stlen_a=strlen(a), isnull_b=isnull(b)

Saída

um	b	isnull_a	isempty_a	strlen_a	isnull_b
		false	true	0	true
		false	false	1	true
um	1	false	false	1	false

Observação

• Se você executar a consulta acima no Kusto. Explorer, todos os true valores serão exibidos como 1e todos os false valores serão exibidos como 0.
• O Kusto não oferece uma maneira de restringir a coluna de uma tabela de ter valores nulos. Em outras palavras, não há equivalente à restrição do NOT NULL SQL.

Observação

O Kusto não oferece uma maneira de restringir a coluna de uma tabela de ter valores nulos. Em outras palavras, não há equivalente à restrição do NOT NULL SQL.