Tous les produits
Search
Centre de documentation

MaxCompute:FAILIF

Dernière mise à jour :Sep 17, 2026

La fonction FAILIF renvoie la valeur true ou un message d'erreur personnalisé selon l'évaluation d'une expression conditionnelle. Cette rubrique explique comment utiliser la fonction FAILIF.

Syntaxe

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

Paramètres

Paramètre

Obligatoire

Description

condition

Oui

L'expression à évaluer, de type BOOLEAN.

errMsg

Oui

Le message d'erreur à générer, de type STRING.

Valeur de retour

  • Si l'expression conditionnelle est évaluée à true, la fonction renvoie le message d'erreur spécifié errMsg.

  • Si l'expression conditionnelle est évaluée à false, la fonction renvoie la valeur true.

Exemples

  • Exemple 1 : lorsque la condition x<0 est vraie :

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

    Le résultat suivant s'affiche avec le message d'erreur spécifié 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
  • Exemple 2 : lorsque la condition x<0 est fausse :

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

    Le résultat suivant s'affiche :

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