assert()

Procura uma condição. Se a condição for falsa, gerará mensagens de erro e falhará na consulta.

Observação

A assert função é avaliada durante a fase de análise de consulta, antes que otimizações como dobramento constante e curto-circuito de predicado sejam aplicadas.

Observação

Os parâmetros determinados a assert devem ser avaliados para constantes durante a fase de análise de consulta. Em outras palavras, ele pode ser construído a partir de outras expressões referenciando constantes somente e não pode ser associado ao contexto de linha.

Syntax

assert(Condição,Mensagem)

Saiba mais sobre as convenções de sintaxe.

Parâmetros

Nome	Tipo	Obrigatório	Descrição
condition	bool	✔️	A expressão condicional a ser avaliada. A condição deve ser avaliada como constante durante a fase de análise de consulta.
message	string	✔️	A mensagem usada se a asserção for avaliada como false.

Retornos

Retornará true se a condição for true. Gerará um erro semântico se a condição for avaliada falsecomo .

Exemplos

A consulta a seguir define uma função checkLength() que verifica o comprimento da cadeia de caracteres de entrada e usa assert para validar o parâmetro de comprimento de entrada (verifica se ele é maior que zero).

Executar a consulta

let checkLength = (len:long, s:string)
{
    assert(len > 0, "Length must be greater than zero") and
    strlen(s) > len
};
datatable(input:string)
[
    '123',
    '4567'
]
| where checkLength(len=long(-1), input)

A execução dessa consulta gera um erro: assert() has failed with message: 'Length must be greater than zero'

Exemplo de execução com entrada válida len :

Executar a consulta

let checkLength = (len:long, s:string)
{
    assert(len > 0, "Length must be greater than zero") and strlen(s) > len
};
datatable(input:string)
[
    '123',
    '4567'
]
| where checkLength(len=3, input)

Saída

input
4567

A consulta a seguir sempre falhará, demonstrando que a assert função é avaliada mesmo que o where b operador não retorne dados quando b for false:

let b=false;
print x="Hello"
| where b
| where assert(b, "Assertion failed")