pgsql.cc 提供对 postgresql.org 官网内容的中文翻译,由 Pigsty 团队维护。
CREATE LANGUAGE — 定义一种新的过程语言
CREATE [ OR REPLACE ] [ TRUSTED ] [ PROCEDURAL ] LANGUAGEnameHANDLERcall_handler[ INLINEinline_handler] [ VALIDATORvalfunction] CREATE [ OR REPLACE ] [ TRUSTED ] [ PROCEDURAL ] LANGUAGEname
CREATE LANGUAGE在 PostgreSQL数据库中注册一种新的过程语言。随后,就可以用这种新语言定义函数和过程。
CREATE LANGUAGE实际上是将该语言名称与负责执行用这种语言编写的函数的处理器函数关联起来。关于语言处理器的更多信息,参见第 57 章。
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(见第 52.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扩展。
译文有误、术语不当或页面显示问题,请到译文仓库 pgsty/pgdoc 报告译文问题。英文原文本身的问题请通过上游文档表单反馈给 PostgreSQL 文档维护者。