通过

EXECUTE IMMEDIATE

适用于：勾选“是” Databricks SQL 勾选“是” Databricks Runtime 14.3 及更高版本

执行作为 STRING 提供的 SQL 语句。 该语句可以选择将参数传递给参数标记，并将结果分配给变量。

语法

EXECUTE IMMEDIATE sql_string
        [ INTO var_name [, ...] ]
        [ USING { arg_expr [ AS ] [alias] } [, ...] ]

为了与其他 SQL 方言兼容，EXECUTE IMMEDIATE 还支持 USING ( { arg_expr [ AS ] [alias] } [, ...] )

参数

  • sql_string

    一个STRING常量表达式，用于生成格式正确的 SQL 语句。

    如果 sql_string 包含参数占位符，那么它们必须全部为位置型（?）或全部为命名型（:parm1）。

    在 Databricks Runtime 17.3 sql_string 之前，必须是字面量或变量。 不能嵌套 EXECUTE IMMEDIATE 语句。

  • INTO ( var_name [, ...] )

    （可选）将单个行查询的结果返回到 SQL 变量中。 如果查询未返回任何行，则结果为 NULL。

    如果语句不是查询，Azure Databricks 将引发 INVALID_STATEMENT_FOR_EXECUTE_INTO 错误。

    如果查询返回多行，Azure Databricks 将引发 ROW_SUBQUERY_TOO_MANY_ROWS 错误。

    • var_name

      SQL 变量。 变量不能多次引用。

  • USING { arg_expr [ AS ] [alias] } [, ...]

    （可选）如果 sql_string 包含参数标记，则值将绑定到参数。

    • arg_expr

      绑定到参数标记的常量表达式。 如果参数标记未命名，则按位置进行绑定。 对于命名的参数标记，将按名称进行绑定。

    在 Databricks Runtime 17.3 arg_expr 之前，必须是文本或 变量。

    • alias

      替代用于将 arg_expr 绑定到命名参数标记的名称。 每个命名参数标记必须匹配一次。 并非所有 arg_expr 都必须匹配。

示例

-- A self-contained execution using a literal string
> EXECUTE IMMEDIATE 'SELECT SUM(c1) FROM VALUES(?), (?) AS t(c1)' USING 5, 6;
  11

-- A SQL string composed in a SQL variable
> DECLARE sqlStr = 'SELECT SUM(c1) FROM VALUES(?), (?) AS t(c1)';
> DECLARE arg1 = 5;
> DECLARE arg2 = 6;
> EXECUTE IMMEDIATE sqlStr USING arg1, arg2;
  11

-- Using the INTO clause
> DECLARE sum INT;
> DECLARE sqlStr = 'SELECT SUM(c1) FROM VALUES(:first), (:second) AS t(c1)';
> EXECUTE IMMEDIATE sqlStr INTO sum USING arg1, arg2;
> SELECT sum;
  11

-- Using named parameter markers
> DECLARE sum INT;
> DECLARE sqlStr = 'SELECT SUM(c1) FROM VALUES(:first), (:second) AS t(c1)';
> EXECUTE IMMEDIATE sqlStr INTO sum USING (5 AS first, arg2 AS second);
> SELECT sum;
  11

-- Using constant expressions
> DECLARE func STRING DEFAULT 'sum';
> EXECUTE IMMEDIATE 'SELECT ' || func || '(c1) FROM VALUES(:first), (:second) AS t(c1)'
  USING 5 + 7 AS first, length('hello') AS second;
 19