適用於:
Databricks SQL
Databricks Runtime 16.3 和以上版本
針對查詢所傳回的每個數據列重複執行語句清單。
這個語句只能在複合語句 中使用,。
語法
[ label : ] FOR [ variable_name AS ] query
DO
{ stmt ; } [...]
END FOR [ label ]
參數
-
這是迴圈的一個可選標籤,在所有包含
FOR語句的語句標籤中是唯一的。 如果指定結束標籤,它必須符合開始標籤。 標籤可用來 LEAVE 或 ITERATE 迴圈。 要限定迴圈欄位參考,請使用variable_name,而不是label。 -
當參考游標中的列時,您可以使用選填名稱作為限定符。 在 Databricks SQL 及 Databricks Runtime 18.0 及以上版本中,你可以用 IDENTIFIER 子句 指定名稱,並加上字串文字或 字串參數標記,例如
FOR IDENTIFIER('row') AS ...。 stmtSQL 語句
筆記
如果查詢在迴圈主體內修改的數據表上運作,則語意取決於數據源。
針對 Delta 數據表,查詢會維持不受影響。
如果 FOR 循環因為 LEAVE 語句或錯誤狀況而過早完成,Databricks 並不保證查詢的完整執行。
當查詢執行期間發生例外狀況或副作用時,Databricks 不保證這些事件發生在迴圈中的時間點。
通常 FOR 迴圈可以取代為關係型查詢,這通常更有效率。
例子
-- sum up all odd numbers from 1 through 10
> BEGIN
DECLARE sum INT DEFAULT 0;
sumNumbers: FOR row AS SELECT num FROM range(1, 20) AS t(num) DO
IF num > 10 THEN
LEAVE sumNumbers;
ELSEIF num % 2 = 0 THEN
ITERATE sumNumbers;
END IF;
SET sum = sum + row.num;
END FOR sumNumbers;
VALUES (sum);
END;
25
-- Compare with the much more efficient relational computation:
> SELECT sum(num) FROM range(1, 10) AS t(num) WHERE num % 2 = 1;
25