CREATE LANGUAGE — 定义一种新的过程语言
CREATE [ OR REPLACE ] [ TRUSTED ] [ PROCEDURAL ] LANGUAGEnameHANDLERcall_handler[ INLINEinline_handler] [ VALIDATORvalfunction] CREATE [ OR REPLACE ] [ TRUSTED ] [ PROCEDURAL ] LANGUAGEname
CREATE LANGUAGE在 PostgreSQL数据库中注册一种新的 过程语言。随后,就可以用这种新语言定义函数和过程。
CREATE LANGUAGE实际上是将该语言名称与负责执行 用这种语言编写的函数的处理器函数关联起来。关于语言处理器的更多信息, 参见Chapter 54。
CREATE OR REPLACE LANGUAGE会创建一种新语言, 或者替换现有定义。如果该语言已经存在,其参数会按命令更新;但该语言的 所有权和权限设置不会改变,并且任何现有的、用该语言编写的函数都假定仍然 有效。
必须拥有PostgreSQL超级用户权限,才能注册 新语言或更改现有语言的参数。不过,一旦语言创建完成,就可以把它的所有权 赋予非超级用户;随后该用户可以删除它、更改其权限、重命名它,或者将其 转让给新的所有者。(不过,不要把底层 C 函数的所有权赋予非超级用户;那样 会为该用户制造一条权限提升路径。)
不提供任何处理器函数的CREATE LANGUAGE形式已经过时。 为了向后兼容旧的转储文件,它会被解释为CREATE EXTENSION。 如果该语言已被打包为一个同名扩展,这种写法就能工作,而这正是安装过程 语言的惯常方式。
TRUSTED #TRUSTED指定该语言不会让用户获得其原本 无权访问的数据访问能力。如果在注册该语言时省略这个关键字,只有 拥有PostgreSQL超级用户权限的用户 才能使用该语言创建新函数。
PROCEDURAL #这是一个噪声词。
name #新过程语言的名称。该名称在数据库内必须唯一。
HANDLER call_handler #call_handler 是一个先前注册的函数名称,它会被调用来执行该过程语言中的函数。 过程语言的调用处理器必须使用某种编译型语言(例如 C)编写,并采用 版本 1 调用约定。它必须在PostgreSQL 中注册为一个不带参数且返回language_handler类型的 函数。language_handler是一种占位符类型,仅用于把 该函数标识为调用处理器。
INLINE inline_handler #inline_handler 是一个先前注册的函数名称,它会被调用来执行该语言中的匿名代码块 (DO命令)。 如果没有指定inline_handler 函数,则该语言不支持匿名代码块。该处理器函数必须接受一个 internal类型的参数,该参数将是 DO命令的内部表示,并且它通常返回 void。处理器的返回值会被忽略。
VALIDATOR valfunction #valfunction 是一个先前注册的函数名称,在创建该语言中的新函数时会调用它来验证 该新函数。如果没有指定验证器函数,那么新函数在创建时不会被检查。 验证器函数必须接受一个oid类型的参数,它将是待创建 函数的 OID,并且它通常返回void。
验证器函数通常会检查函数体的语法正确性,但它也可以检查函数的其他 属性,例如该语言是否支持某些参数类型。要报告错误,验证器函数 应使用ereport()函数。函数的返回值会被忽略。
使用DROP LANGUAGE删除过程语言。
系统目录pg_language(见Section 50.29)记录当前已安装语言的信息。此外, psql的\dL命令也会列出 已安装的语言。
要用某种过程语言创建函数,用户必须拥有该语言的 USAGE权限。默认情况下,对于受信任的语言, USAGE会授予PUBLIC(即所有人)。 如果需要,也可以撤销这项授权。
过程语言是各个数据库本地的。不过,可以将某种语言安装到 template1数据库中,这样它就会在之后创建的所有 数据库中自动可用。
创建新过程语言的最简步骤如下:
CREATE FUNCTION plsample_call_handler() RETURNS language_handler
AS '$libdir/plsample'
LANGUAGE C;
CREATE LANGUAGE plsample
HANDLER plsample_call_handler;
通常这会写在扩展的创建脚本中,而用户会通过下面的命令安装该扩展:
CREATE EXTENSION plsample;
CREATE LANGUAGE是一种 PostgreSQL扩展。
如果您发现文档中有不正确的内容、与您使用特定功能的经验不符或需要进一步说明,请使用此表单来报告文档问题。