FAILIF - 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 | 
+------------+------+