人大金仓数据库KingbaseES --PLSQL 的FOREACH语句

关键字：

FOREACH、人大金仓、KingbaseES

FOREACH语句介绍

FOREACH 循环很像一个 FOR 循环，但不是通过一个 SQL 查询返回的行进行迭代，它通过数组值的元素来迭代。

通常，FOREACH 意味着通过一个组合值表达式的部件迭代；用于通过除数组之外组合类型进行循环的变体可能会在未来被加入。

1. FOREACH语句的语法

foreach_statement ::=

[ <<label>> ]

FOREACH target [ SLICE number ] IN ARRAY expression LOOP

statements

END LOOP [ label ];

1. 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]]);

参考资料