CASE (Snowflake Scripting)¶

CASE 语句提供一种指定多个条件的方法。

有关分支结构的更多信息，请参阅使用条件逻辑。

备注

本 Snowflake Scripting 结构仅在 Snowflake Scripting 区块内有效。

语法¶

简单 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 |
+-------------------+