受支持版本: 当前版本 (18) / 17 / 16 / 15 / 14
开发版本: devel

CREATE LANGUAGE

CREATE LANGUAGE — 定义一种新的过程语言

Synopsis

CREATE [ OR REPLACE ] [ TRUSTED ] [ PROCEDURAL ] LANGUAGE name
    HANDLER call_handler [ INLINE inline_handler ] [ VALIDATOR valfunction ]
CREATE [ OR REPLACE ] [ TRUSTED ] [ PROCEDURAL ] LANGUAGE name

描述

CREATE LANGUAGEPostgreSQL数据库中注册一种新的 过程语言。随后,就可以用这种新语言定义函数和过程。

CREATE LANGUAGE实际上是将该语言名称与负责执行 用这种语言编写的函数的处理器函数关联起来。关于语言处理器的更多信息, 参见Chapter 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(见Section 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扩展。

提交更正

如果您发现文档中有不正确的内容、与您使用特定功能的经验不符或需要进一步说明,请使用此表单来报告文档问题。