用 PL/pgSQL 编写的函数通过执行 CREATE FUNCTION 命令向服务器定义。这样的命令通常看起来像这样:
CREATE FUNCTION somefunc(integer, text) RETURNS integer
AS 'function body text
'
LANGUAGE plpgsql;
就 CREATE FUNCTION
而言,函数体只是一个字符串文字。使用美元符号引用(请参见 第 4.1.2.4 节)来编写函数体通常很有帮助,而不是使用普通的单引号语法。如果不使用美元符号引用,函数体中的任何单引号或反斜杠都必须通过双写来转义。本章中的几乎所有示例都使用美元符号引用的文字作为其函数体。
PL/pgSQL 是一种块结构语言。函数体的完整文本必须是一个块。块定义如下:
[ <<label
>> ] [ DECLAREdeclarations
] BEGINstatements
END [label
];
块中的每个声明和每个语句都以分号结尾。出现在另一个块内的块在 END
之后必须有一个分号,如上所示;但是,结束函数体的最后一个 END
不需要分号。
一个常见的错误是在 BEGIN
之后立即写一个分号。这是不正确的,会导致语法错误。
只有当您想在 EXIT
语句中使用该块,或者限定该块中声明的变量的名称时,才需要label
。如果在 END
之后给出标签,则它必须与块开头的标签匹配。
所有关键字都不区分大小写。标识符会隐式转换为小写,除非用双引号括起来,就像在普通 SQL 命令中一样。
注释在 PL/pgSQL 代码中的工作方式与在普通 SQL 中相同。双破折号 (--
) 开始一个注释,该注释延伸到行尾。/*
开始一个块注释,该注释延伸到匹配的 */
。块注释可以嵌套。
块的语句部分中的任何语句都可以是子块。子块可用于逻辑分组或将变量局部化到一小组语句。在子块中声明的变量会在子块的持续时间内屏蔽任何外部块中具有相似名称的变量;但是,如果使用块的标签限定其名称,您仍然可以访问外部变量。例如:
CREATE FUNCTION somefunc() RETURNS integer AS $$ << outerblock >> DECLARE quantity integer := 30; BEGIN RAISE NOTICE 'Quantity here is %', quantity; -- Prints 30 quantity := 50; -- -- Create a subblock -- DECLARE quantity integer := 80; BEGIN RAISE NOTICE 'Quantity here is %', quantity; -- Prints 80 RAISE NOTICE 'Outer quantity here is %', outerblock.quantity; -- Prints 50 END; RAISE NOTICE 'Quantity here is %', quantity; -- Prints 50 RETURN quantity; END; $$ LANGUAGE plpgsql;
实际上,在任何 PL/pgSQL 函数的主体周围都有一个隐藏的“外部块”。此块提供了函数参数(如果有)的声明,以及一些特殊变量,例如 FOUND
(请参见 第 41.5.5 节)。外部块使用函数的名称标记,这意味着可以使用函数的名称来限定参数和特殊变量。
重要的是不要将 PL/pgSQL 中用于对语句进行分组的 BEGIN
/END
的使用与用于事务控制的具有相似名称的 SQL 命令混淆。PL/pgSQL 的 BEGIN
/END
仅用于分组;它们不启动或结束事务。有关在 PL/pgSQL 中管理事务的信息,请参见 第 41.8 节。此外,包含 EXCEPTION
子句的块实际上形成了一个子事务,该子事务可以回滚而不影响外部事务。有关这方面的更多信息,请参见 第 41.6.8 节。
如果您发现文档中有任何不正确、与您使用特定功能的经验不符或需要进一步澄清的地方,请使用 此表单 来报告文档问题。