SQL COMMAND · 函数与过程
CREATE LANGUAGE
定义一种新的过程语言
CREATE函数与过程引入 10(基线)现存至 20 devel1 次语法变更
- 动词
CREATE- 对象
LANGUAGE- 分组
- 函数与过程
- 引入版本
- 10(基线)
- 状态
- 现存
- 语法变更次数
- 1
- 手册小节数
- 6
版本轨迹
相对 PostgreSQL 17 语法未变,正文有更新。
语法铁道图 PostgreSQL 18
沿轨道从左向右阅读,分岔表示选择,绕行表示可选,回环表示重复。方框为参数,点击带下划线的参数可展开子规则。
CREATE LANGUAGE · 语法 2
语法概要
CREATE [ OR REPLACE ] [ TRUSTED ] [ PROCEDURAL ] LANGUAGEnameHANDLERcall_handler[ INLINEinline_handler] [ VALIDATORvalfunction] CREATE [ OR REPLACE ] [ TRUSTED ] [ PROCEDURAL ] LANGUAGEname
描述
CREATE LANGUAGE在 PostgreSQL数据库中注册一种新的 过程语言。随后,就可以用这种新语言定义函数和过程。
CREATE LANGUAGE实际上是将该语言名称与负责执行 用这种语言编写的函数的处理器函数关联起来。关于语言处理器的更多信息, 参见Chapter 57。
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(见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扩展。
另见
语法演化
相邻大版本之间的差异,新的在前。版本号链接到对应快照。
PostgreSQL 18← 17正文更新
正文更新PostgreSQL 15← 14正文更新
正文更新PostgreSQL 14← 13正文更新
正文更新PostgreSQL 13← 12语法变化
+ CREATE [ OR REPLACE ] [ TRUSTED ] [ PROCEDURAL ] LANGUAGE name− CREATE [ OR REPLACE ] [ PROCEDURAL ] LANGUAGE name正文更新PostgreSQL 12← 11正文更新
正文更新PostgreSQL 11← 10正文更新
正文更新
同组命令
| 命令 | 动词 | 对象 | 版本变动 | 最近变更 |
|---|---|---|---|---|
CALL | CALL | — | — | |
| 调用一个过程 | 现存 | |||
DO | DO | — | — | |
| 执行匿名代码块 | 现存 | |||
CREATE AGGREGATE | CREATE | AGGREGATE | 203 次 | |
| 定义一个新的聚合函数 | 现存 | |||
ALTER AGGREGATE | ALTER | AGGREGATE | 141 次 | |
| 更改一个聚合函数的定义 | 现存 | |||
DROP AGGREGATE | DROP | AGGREGATE | — | |
| 移除一个聚合函数 | 现存 | |||
CREATE FUNCTION | CREATE | FUNCTION | 143 次 | |
| 定义一个新函数 | 现存 | |||
ALTER FUNCTION | ALTER | FUNCTION | 143 次 | |
| 更改函数的定义 | 现存 | |||
DROP FUNCTION | DROP | FUNCTION | — | |
| 移除一个函数 | 现存 | |||
CREATE LANGUAGE | CREATE | LANGUAGE | 131 次 | |
| 定义一种新的过程语言 | 现存 | |||
ALTER LANGUAGE | ALTER | LANGUAGE | 141 次 | |
| 更改一种过程语言的定义 | 现存 | |||
DROP LANGUAGE | DROP | LANGUAGE | — | |
| 移除一种过程语言 | 现存 | |||
CREATE PROCEDURE | CREATE | PROCEDURE | 141 次 | |
| 定义一个新过程 | 现存 | |||
ALTER PROCEDURE | ALTER | PROCEDURE | 142 次 | |
| 更改过程的定义 | 现存 | |||
DROP PROCEDURE | DROP | PROCEDURE | — | |
| 移除一个过程 | 现存 | |||
ALTER ROUTINE | ALTER | ROUTINE | 142 次 | |
| 更改一个例程的定义 | 现存 | |||
DROP ROUTINE | DROP | ROUTINE | — | |
| 移除一个例程 | 现存 | |||
CREATE TRANSFORM | CREATE | TRANSFORM | — | |
| 定义一个新的转换 | 现存 | |||
DROP TRANSFORM | DROP | TRANSFORM | — | |
| 移除一个转换 | 现存 | |||