CREATE LANGUAGE
CREATE LANGUAGE — 定义一种新的过程语言
大纲
CREATE [ OR REPLACE ] [ TRUSTED ] [ PROCEDURAL ] LANGUAGEnameHANDLERcall_handler[ INLINEinline_handler] [ VALIDATORvalfunction] CREATE [ OR REPLACE ] [ TRUSTED ] [ PROCEDURAL ] LANGUAGEname
描述
CREATE LANGUAGE 在
PostgreSQL 数据库中注册一种新的过程语言。随后,就可以用这种新语言定义函数和过程。
CREATE LANGUAGE 实际上是将该语言名称与负责执行用这种语言编写的函数的处理器函数关联起来。关于语言处理器的更多信息,参见第 55 章。
CREATE OR REPLACE LANGUAGE 会创建一种新语言,或者替换现有定义。如果该语言已经存在,其参数会按命令更新;但该语言的所有权和权限设置不会改变,并且任何现有的、用该语言编写的函数都假定仍然有效。
必须拥有 PostgreSQL 超级用户权限,才能注册新语言或更改现有语言的参数。不过,一旦语言创建完成,就可以把它的所有权赋予非超级用户;随后该用户可以删除它、更改其权限、重命名它,或者将其转让给新的所有者。(不过,不要把底层 C 函数的所有权赋予非超级用户;那样会为该用户制造一条权限提升路径。)
不提供任何处理器函数的 CREATE LANGUAGE 形式已经过时。为了向后兼容旧的转储文件,它会被解释为 CREATE EXTENSION。如果该语言已被打包为一个同名扩展,这种写法就能工作,而这正是安装过程语言的惯常方式。
参数
TRUSTEDTRUSTED指定该语言不会让用户获得其原本无权访问的数据访问能力。如果在注册该语言时省略这个关键字,只有拥有 PostgreSQL 超级用户权限的用户才能使用该语言创建新函数。PROCEDURAL这是一个噪声词。
name新过程语言的名称。该名称不能与数据库中其他语言的名称重复。
为了向后兼容,名称可以用单引号括起来。
HANDLERcall_handlercall_handler是一个先前注册的函数名称,它会被调用来执行该过程语言中的函数。过程语言的调用处理器必须使用某种编译型语言(例如 C)编写,并采用版本 1 调用约定。它必须在 PostgreSQL 中注册为一个不带参数且返回language_handler类型的函数。language_handler是一种占位符类型,仅用于把该函数标识为调用处理器。INLINEinline_handlerinline_handler是一个先前注册的函数名称,它会被调用来执行该语言中的匿名代码块(DO 命令)。如果没有指定inline_handler函数,则该语言不支持匿名代码块。该处理器函数必须接受一个internal类型的参数,该参数将是DO命令的内部表示,并且它通常返回void。处理器的返回值会被忽略。VALIDATORvalfunctionvalfunction是一个先前注册的函数名称,在创建该语言中的新函数时会调用它来验证该新函数。如果没有指定验证器函数,那么新函数在创建时不会被检查。验证器函数必须接受一个oid类型的参数,它将是待创建函数的 OID,并且它通常返回void。验证器函数通常会检查函数体的语法正确性,但它也可以检查函数的其他属性,例如该语言是否支持某些参数类型。要报告错误,验证器函数应使用
ereport()函数。函数的返回值会被忽略。
注解
使用 DROP LANGUAGE 删除过程语言。
系统目录 pg_language(见第 51.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 扩展。