La fonction FAILIF renvoie true ou génère une erreur avec un message personnalisé, selon le résultat de l'expression évaluée. Cette rubrique décrit la syntaxe et l'utilisation de la fonction FAILIF.
Syntaxe
BOOLEAN FAILIF(BOOLEAN <condition>, STRING <errMsg>); Paramètres
|
Paramètre |
Obligatoire |
Description |
|
condition |
Oui |
Expression à évaluer, de type |
|
errMsg |
Oui |
Message d'erreur à afficher, de type |
Valeur de retour
Si l'expression condition est vraie (true), la fonction lève une exception avec le message constant spécifié dans
errMsg.Si l'expression condition est fausse (false), la fonction renvoie true.
Exemples
-
Lorsque la condition x<0 est vérifiée (résultat true).
SELECT x, FAILIF(x<0,'Error: x must be positive') FROM (SELECT -1 AS x);Le résultat ci-dessous inclut le message d'erreur constant défini dans la fonction 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 -
Lorsque la condition x<0 n'est pas vérifiée (résultat false).
SELECT x, FAILIF(x<0,'Error: x must be positive') FROM (SELECT 1 AS x);Le résultat est le suivant.
+------------+------+ | x | _c1 | +------------+------+ | 1 | true | +------------+------+