共用方式為

EXECUTE IMMEDIATE

  • 發行項

適用於：核取記號為「是」 Databricks SQL 核取記號為「是」 Databricks Runtime 14.3 和更新版本

執行提供做為的 STRINGSQL 語句。 語句選擇性地將自變數傳遞至 參數標記， 並將結果指派給 變數。

語法

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

為了與其他 SQL 方言相容， EXECUTE IMMEDIATE 也支援 USING ( { arg_expr [ AS ] [alias] } [, ...] )

Parameters

  • sql_string

    常 STRING 值或變數，產生格式正確的 SQL 語句。

    您無法巢狀 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 包含參數標記，則將 values 綁定至 parameters。

    • 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;
> EXECUTE IMMEDIATE sqlStr INTO sum USING arg1, arg2;
> SELECT sum;
  11

-- Using named parameter markers
> SET VAR 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