CASE （Snowflakeスクリプト）¶

CASE ステートメントは、複数の条件を指定する方法を提供します。

分岐構造の詳細については、条件付きロジックの操作をご参照ください。

注釈

この Snowflakeスクリプト構造は、 Snowflakeスクリプトブロック内でのみ有効です。

構文¶

単純な CASE ステートメント:

CASE ( <expression_to_match> )
    WHEN <expression> THEN
        <statement>;
        [ <statement>; ... ]
    [ WHEN ... ]
    [ ELSE
        <statement>;
        [ <statement>; ... ]
    ]
END [ CASE ] ;

条件:

expression_to_match
一致する式。

expression
この式の値が expression_to_match の値と一致する場合は、この句のステートメントが実行されます。

statement
ステートメントは、次のいずれかになります。

単一の SQL ステートメント（CALL を含む）。

制御フローステートメント（例: ループまたは分岐ステートメント）。

ネストされたブロック。

検索された CASE ステートメント:

CASE
    WHEN <boolean_expression> THEN
        <statement>;
        [ <statement>; ... ]
    [ WHEN ... ]
    [ ELSE
        <statement>;
        [ <statement>; ... ]
    ]
END [ CASE ] ;

条件:

boolean_expression
この式が TRUE と評価された場合は、この句のステートメントが実行されます。

statement
ステートメントは、次のいずれかになります。

単一の SQL ステートメント（CALL を含む）。

制御フローステートメント（例: ループまたは分岐ステートメント）。

ネストされたブロック。

使用上の注意¶

CASE の複数の分岐が式に一致する場合は、最初の分岐のみが使用されます。
式を比較すると、 NULL は NULL と一致しません。NULL 値を明示的にテストする場合は、 IS [ NOT ] NULL を使用します。

例¶

この例は、単純な CASE ステートメントを示しています。

CREATE PROCEDURE case_demo_01(v VARCHAR)
RETURNS VARCHAR
LANGUAGE SQL
AS
  BEGIN
    CASE (v)
      WHEN 'first choice' THEN
        RETURN 'one';
      WHEN 'second choice' THEN
        RETURN 'two';
      ELSE
        RETURN 'unexpected choice';
    END;
  END;

Note: If you use Snowflake CLI, SnowSQL, the Classic Console, or the execute_stream or execute_string method in Python Connector code, use this example instead (see Using Snowflake Scripting in Snowflake CLI, SnowSQL, and Python Connector):

CREATE PROCEDURE case_demo_01(v VARCHAR)
RETURNS VARCHAR
LANGUAGE SQL
AS
$$
    BEGIN
        CASE (v)
            WHEN 'first choice' THEN
                RETURN 'one';
            WHEN 'second choice' THEN
                RETURN 'two';
            ELSE
                RETURN 'unexpected choice';
       END CASE;
    END;
$$
;

このストアドプロシージャを呼び出すと、プロシージャは次の出力を生成します。

CALL case_demo_01('second choice');
+--------------+
| CASE_DEMO_01 |
|--------------|
| two          |
+--------------+

この例は、検索された CASE ステートメントを示しています。

CREATE PROCEDURE case_demo_2(v VARCHAR)
RETURNS VARCHAR
LANGUAGE SQL
AS
  BEGIN
    CASE
      WHEN v = 'first choice' THEN
        RETURN 'one';
      WHEN v = 'second choice' THEN
        RETURN 'two';
      ELSE
        RETURN 'unexpected choice';
    END;
  END;

CREATE PROCEDURE case_demo_2(v VARCHAR)
RETURNS VARCHAR
LANGUAGE SQL
AS
$$
    BEGIN
        CASE 
            WHEN v = 'first choice' THEN
                RETURN 'one';
            WHEN v = 'second choice' THEN
                RETURN 'two';
            ELSE
                RETURN 'unexpected choice';
       END CASE;
    END;
$$
;

このストアドプロシージャを呼び出すと、プロシージャは次の出力を生成します。

CALL case_demo_2('none of the above');
+-------------------+
| CASE_DEMO_2       |
|-------------------|
| unexpected choice |
+-------------------+