用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; -- -- 创建一个子块 -- 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
之类特殊变量(见第 42.5.5 节)。外层块被标上函数的名称,这意味着参数和特殊变量可以用该函数的名称限定。
重要的是不要把PL/pgSQL中用来分组语句的BEGIN
/END
与用于事务控制的同名 SQL 命令弄混。PL/pgSQL的BEGIN
/END
只用于分组,它们不会开始或结束一个事务。函数和触发器过程总是被执行在由一个外层查询建立的事务中 — 它们不能开始或提交那个事务,因为没有环境给它们执行。不过,一个包含EXCEPTION
子句的块实际上会形成一个子事务,它可以被回滚而不影响外层事务。详见第 42.6.6 节。