36.3. PL/pgSQL的结构

PL/pgSQL是一种块结构的语言。 函数定义的所有文本都必须是一个。 一个块用下面的方法定义:

[ <<label>> ]
[ DECLARE
    declarations ]
BEGIN
    statements
END [ label ];

块中的每个声明和每条语句都是用一个分号终止的, 如果一个子块在另外一个块里,那么 END 后面必须有个分号,如上所述; 不过结束函数体的最后的 END 可以不要这个分号。

所有关键字和标识符都可以用混和大小写的方式来写。标识符被隐含地转换成小写字符,除非被双引号包围。

PL/pgSQL 里有两种类型地注释。一个双破折号(--) 引出一个扩展到该行结尾的注释。一个 /* 引出一个块注释,一直扩展到下一次 */ 的出现。 块注释不能嵌套,但是双破折号注释可以包围在块注释里面,并且双破折号可以隐藏一个块注释分隔符 /**/

在一个块的语句段里的任何语句都可以是一个子块。 子块可以用于逻辑分组或者把变量局部化为作用于一个比较小的语句组。

在语句块前面的声明段(declarations section)里定义的变量在每次进入语句块时都初始化为它们的缺省值, 而不是每次函数调用时初始化一次。比如:

CREATE FUNCTION somefunc() RETURNS integer AS $$
DECLARE
   quantity integer := 30;
BEGIN
   RAISE NOTICE 'Quantity here is %', quantity;  -- 在这里的数量是 30
   quantity := 50;
   --
   -- 创建一个子块
   --
   DECLARE
      quantity integer := 80;
   BEGIN
      RAISE NOTICE 'Quantity here is %', quantity;  -- 在这里的数量是 80
   END;

   RAISE NOTICE 'Quantity here is %', quantity;  -- 在这里的数量是 50

   RETURN quantity;
END;
$$ LANGUAGE plpgsql;

我们一定不要把PL/pgSQL里用于语句分组的 BEGIN/END 和用于事务控制的数据库命令搞混了。 PL/pgSQLBEGIN/END 只是用于分组(译注∶象 C 里的 {}); 它们不会开始和结束一个事务。 函数和触发器过程总是在一个由外层命令建立起来的事务里执行 — 它们无法开始或者提交事务,因为 PostgreSQL 没有嵌套事务。 不过,一个包含 EXCEPTION 子句的块实际上形成一个子事务,它可以在不影响外层事务的情况下回滚。 更多相关信息请参阅 Section 36.7.5