关键字:
FOREACH、人大金仓、KingbaseES
FOREACH语句介绍
FOREACH 循环很像一个 FOR 循环,但不是通过一个 SQL 查询返回的行进行迭代,它通过数组值的元素来迭代。
通常,FOREACH 意味着通过一个组合值表达式的部件迭代;用于通过除数组之外组合类型进行循环的变体可能会在未来被加入。
- FOREACH语句的语法
foreach_statement ::=
[ <<label>> ]
FOREACH target [ SLICE number ] IN ARRAY expression LOOP
statements
END LOOP [ label ];
- FOREACH语句的语法解析
foreach_statement
label
标识 foreach_statement 的标签(参见statement ::= ,label ::= )。CONTINUE、EXIT 和GOTO 语句可以引用这个标签。
标签提高了可读性,尤其是当 LOOP 语句嵌套时,但前提是确保 END LOOP 语句中的标签与同一 LOOP 语句开头的标签匹配。
target
target 变量必须是一个数组,并且它接收数组值的连续切片,其中每一个切片都有 SLICE 指定的维度数。
元素会被按照存储顺序访问,而不管数组的维度数。
尽管 target 通常只是一个单一变量,当通过一个组合值(记录)的数组循环时,它可以是一个变量列表。在那种情况下,对每一个数组元素,变量会被从组合值的连续列赋值。
SLICE
通过一个正 SLICE 值,FOREACH 通过数组的切片而不是单一元素迭代。SLICE 值必须是一个不大于数组维度数的整数常量。
如果没有 SLICE,或者如果没有指定 SLICE 0,循环会通过计算 expression 得到的数组的个体元素进行迭代。target 变量被逐一赋予每一个元素值,并且循环体会为每一个元素执行。
statements
语句中的 EXIT、EXIT WHEN、CONTINUE 或 CONTINUE WHEN 会导致循环或循环的当前迭代提前结束。
expression
需要进行计算的表达式。用于数组的个体元素进行迭代。
FOREACH语句的使用场景
(1)在一个数组上循环的 FOREACH 语句
\set SQLTERM /
CREATE OR REPLACE FUNCTION sum(int[]) RETURNS int8 AS
DECLARE
s int8 := 0;
x int;
BEGIN
FOREACH x IN ARRAY $1
LOOP
s := s + x;
END LOOP;
RETURN s;
END;
/
\set SQLTERM ;
SELECT sum(ARRAY[1,2,3]);
(2)一个通过一维切片迭代的例子:
\set SQLTERM /
CREATE OR REPLACE FUNCTION scan_rows(int[]) RETURNS void AS
DECLARE
x int[];
BEGIN
FOREACH x SLICE 1 IN ARRAY $1
LOOP
RAISE NOTICE 'row = %', x;
END LOOP;
END;
/
\set SQLTERM ;
SELECT scan_rows(ARRAY[[1,2,3],[4,5,6],[7,8,9],[10,11,12]]);