FAILIF_云原生大数据计算服务 MaxCompute(MaxCompute)-阿里云帮助中心

FAILIF函数支持根据表达式判断结果返回true或自定义错误信息的报错提示。本文为您介绍FAILIF函数使用命令。

命令格式

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

参数说明

参数	是否必填	说明
condition	是	要判断的表达式，`BOOLEAN`类型。
errMsg	是	需要抛出的错误信息，`STRING` 类型。

返回结果

condition表达式的结果为true时，抛出指定的常量信息errMsg。
condition表达式的结果为false时，返回true。

使用示例

当判断条件 x<0 成立时（为true）。

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

返回结果如下，其中会包含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

当判断条件 x<0 不成立时（为false）。

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

返回结果如下。

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