CREATE LANGUAGE
功能描述
定义一种新的过程语言
语法格式
CREATE [ OR REPLACE ] [ PROCEDURAL ] LANGUAGE name
CREATE [ OR REPLACE ] [ TRUSTED ] [ PROCEDURAL ] LANGUAGE name
HANDLER call_handler [ INLINE inline_handler ] [ VALIDATOR valfunction ]
参数说明
TRUSTED
TRUSTED说明该语言并不授权没有权限的用户访问数据。 如果在注册该语言时忽略这个关键字,则只有超级用户权限可以使用。
PROCEDURAL
这是个没有用的字。
name
新过程语言的名称。这个名字应该在数据库的所有语言中唯一。
出于向下兼容的原因,这个名字可以用单引号包围。
HANDLER call_handler
call_handler是一个以前注册过的函数名字, 该函数将被用来执行该过程语言的函数。过程语言的调用处理器必须用一种编译语言(比如 C) 书写,调用风格必须是版本1的调用风格,并且注册为不接受参数并且返回 language_handler类型的函数。language_handler 是用于将函数声明为调用处理器的占位符。
INLINE inline_handler
inline_handler是以前注册过的函数名字, 用来在该语言中执行一个匿名代码块(DO 命令)。 如果没有指定inline_handler函数, 那么该语言不支持匿名代码块。处理器函数必须接受一个internal 类型的参数,这将是DO命令的内部表示,并且它通常返回void。 忽略该处理器的返回值。
VALIDATOR valfunction
valfunction是一个以前注册过的函数名字, 在用该语言创建新函数的时候将用它来校验新函数。如果没有声明校验函数, 那么建立新函数的时候就不会检查它。校验函数必须接受一个类型为oid的参数, 它是将要创建的函数的 OID ,并且通常会返回void。
校验函数通常会检查函数体,看看有没有语法错误,但是它也可以查看函数的其它属性, 比如该语言是否不能处理某种参数类型。校验函数应该用ereport() 函数报告错误。该函数的返回值将被忽略。
示例
创建标准的过程语言的比较好的方法:
CREATE LANGUAGE plperl;
对于pg_pltemplate还不知道的语言,需要下面这样的序列:
CREATE FUNCTION plsample_call_handler() RETURNS language_handler
AS '$libdir/plsample'
LANGUAGE C;
CREATE LANGUAGE plsample
HANDLER plsample_call_handler;