次の方法で共有

EXECUTE IMMEDIATE

適用対象:check marked yes 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

    適切な形式の SQL ステートメントを生成する STRING定数式。

    パラメーターマーカーが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 を名前付きパラメーター マーカーにバインドするために使用される名前をオーバーライドします。 名前付きパラメーター マーカーがマッチする回数はそれぞれ 1 回である必要があります。 すべての 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
  • Last updated on