FAILIF - MaxCompute: Central de Documentação do Alibaba Cloud

A função FAILIF retorna true ou uma mensagem de erro personalizada com base na expressão condicional. Este tópico descreve como usar a função FAILIF.

Sintaxe

BOOLEAN FAILIF(BOOLEAN <condition>, STRING <errMsg>);

Parâmetros

Parâmetro	Obrigatório	Descrição
condition	Sim	Expressão a avaliar, do tipo `BOOLEAN`.
errMsg	Sim	Mensagem de erro a lançar, do tipo `STRING`.

Valor de retorno

Se a expressão condicional for avaliada como verdadeira, a função retornará a mensagem de erro especificada em errMsg.
Se a expressão condicional for avaliada como falsa, a função retornará true.

Exemplos

Exemplo 1: condição x<0 é verdadeira:

SELECT x, FAILIF(x<0,'Error: x must be positive') FROM (SELECT -1 AS x);

O resultado a seguir exibe a mensagem de erro definida na função FAILIF:

ODPS-0130071:[0,0] Semantic analysis exception - physical plan generation failed: SQL Runtime Unretryable Error: ODPS-0121095:Invalid argument - Error: x must be positive

Exemplo 2: condição x<0 é falsa:

SELECT x, FAILIF(x<0,'Error: x must be positive') FROM (SELECT 1 AS x);

Resultado retornado:

+------------+------+
| x          | _c1  | 
+------------+------+
| 1         | true | 
+------------+------+