Beam ZetaSQL 条件式

このページでは、Beam ZetaSQLでサポートされているZetaSQLスカラー関数について説明します。

構文	入力データ型	結果データ型	説明
CASE expr WHEN value THEN result [WHEN ...] [ELSE else_result] END	`expr`と`value`：任意の型	`result`と`else_result`：入力型のスーパータイプ。	`expr`を後続の各`WHEN`句の値と比較し、この比較がtrueを返す最初の結果を返します。残りの`WHEN`句と`else_result`は評価されません。すべての`WHEN`句で`expr = value`の比較がfalseまたは`NULL`を返す場合、`else_result`が存在する場合はそれを返し、存在しない場合は`NULL`を返します。`expr`と`value`式は、暗黙的に共通のスーパータイプに強制型変換できる必要があります。等価比較は、強制型変換された値に対して行われます。`result`と`else_result`の式は、共通のスーパータイプに強制型変換できる必要があります。
CASE WHEN cond1 THEN result [WHEN cond2...] [ELSE else_result] END	`cond`: BOOL	`result`と`else_result`：入力型のスーパータイプ。	後続の各`WHEN`句の条件`cond`を評価し、条件がtrueになる最初の結果を返します。残りの`WHEN`句と`else_result`は評価されません。すべての条件がfalseまたは`NULL`の場合、`else_result`が存在する場合はそれを返し、存在しない場合は`NULL`を返します。`result`と`else_result`の式は、暗黙的に共通のスーパータイプに強制型変換できる必要があります。
COALESCE(expr1, ..., exprN)	任意の型	入力型のスーパータイプ	最初のNULLでない式の値を返します。残りの式は評価されません。すべての入力式は、暗黙的に共通のスーパータイプに強制型変換できる必要があります。
IF(cond, true_result, else_result)	`cond`: BOOL	`true_result`と`else_result`：任意の型。	`cond`がtrueの場合、`true_result`を返し、それ以外の場合は`else_result`を返します。`cond`がtrueの場合、`else_result`は評価されません。`cond`がfalseまたは`NULL`の場合、`true_result`は評価されません。`true_result`と`else_result`は、共通のスーパータイプに強制型変換できる必要があります。
IFNULL(expr, null_result)	任意の型	任意の型または入力型のスーパータイプ。	`expr`が`NULL`の場合、`null_result`を返します。それ以外の場合は、`expr`を返します。`expr`が`NULL`でない場合、`null_result`は評価されません。`expr`と`null_result`は、暗黙的に共通のスーパータイプに強制型変換できる必要があります。`COALESCE(expr, null_result)`の同義語。
NULLIF(expression, expression_to_match)	任意の型TまたはTのサブタイプ	任意の型TまたはTのサブタイプ	`expression = expression_to_match`がtrueの場合、`NULL`を返し、それ以外の場合は`expression`を返します。`expression`と`expression_to_match`は、暗黙的に共通のスーパータイプに強制型変換できる必要があります。等価比較は、強制型変換された値に対して行われます。