↑↓ 选择 ↵ 打开 ⌫ 改范围 完整检索页

pgsql.cc 提供对 postgresql.org 官网内容的中文翻译，由 Pigsty 团队维护。

百科 / SQL 命令 / 函数与过程

SQL COMMAND · 函数与过程

CREATE LANGUAGE

定义一种新的过程语言

define a new procedural language

CREATE函数与过程引入 6.4（基线）现存至 20 devel7 次语法变更

动词
CREATE
对象
LANGUAGE
引入版本
6.4（基线）
状态
现存
语法变更次数
7
手册小节数
6

本站手册 · 18官方文档 ↗

版本轨迹

相对 PostgreSQL 17 语法未变，正文有更新。

语法铁道图 PostgreSQL 18

沿轨道从左向右阅读，分岔表示选择，绕行表示可选，回环表示重复。方框为参数，点击带下划线的参数可展开子规则。

CREATE OR REPLACE TRUSTED PROCEDURAL LANGUAGE name HANDLER call_handler INLINE inline_handler VALIDATOR valfunction
CREATE LANGUAGE · 语法 2
CREATE OR REPLACE TRUSTED PROCEDURAL LANGUAGE name

语法概要

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

PostgreSQL 18 手册 · 查看完整参考页

描述

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 扩展。

另见

ALTER LANGUAGE, CREATE FUNCTION, DROP LANGUAGE, GRANT, REVOKE

语法演化

相邻大版本之间的差异，新的在前。版本号链接到对应快照。

  1. PostgreSQL 18← 17正文更新

    正文更新

  2. PostgreSQL 17← 16正文更新

    正文更新

  3. PostgreSQL 15← 14正文更新

    正文更新

  4. PostgreSQL 14← 13正文更新

    正文更新

  5. PostgreSQL 13← 12语法变化

    + CREATE [ OR REPLACE ] [ TRUSTED ] [ PROCEDURAL ] LANGUAGE name− CREATE [ OR REPLACE ] [ PROCEDURAL ] LANGUAGE name正文更新

  6. PostgreSQL 12← 11正文更新

    正文更新

  7. PostgreSQL 11← 10正文更新

    正文更新

  8. PostgreSQL 10← 9.6正文更新

    正文更新

  9. PostgreSQL 9.6← 9.5正文更新

    正文更新

  10. PostgreSQL 9.5← 9.4正文更新

    正文更新

  11. PostgreSQL 9.4← 9.3正文更新

    正文更新

  12. PostgreSQL 9.3← 9.2正文更新

    正文更新

  13. PostgreSQL 9.2← 9.1正文更新

    正文更新

  14. PostgreSQL 9.1← 9.0正文更新

    正文更新

  15. PostgreSQL 9.0← 8.4语法变化

    + CREATE [ OR REPLACE ] [ PROCEDURAL ] LANGUAGE name+ CREATE [ OR REPLACE ] [ TRUSTED ] [ PROCEDURAL ] LANGUAGE name+ HANDLER call_handler [ INLINE inline_handler ] [ VALIDATOR valfunction ]正文更新

  16. PostgreSQL 8.4← 8.3正文更新

    正文更新

  17. PostgreSQL 8.3← 8.2正文更新

    正文更新

  18. PostgreSQL 8.2← 8.1正文更新

    正文更新

  19. PostgreSQL 8.1← 8.0语法变化

    + CREATE [ PROCEDURAL ] LANGUAGE name正文更新

  20. PostgreSQL 8.0← 7.4正文更新

    正文更新

  21. PostgreSQL 7.4← 7.3语法变化

    + CREATE [ TRUSTED ] [ PROCEDURAL ] LANGUAGE name− CREATE [ TRUSTED ] [ PROCEDURAL ] LANGUAGE langname正文更新

  22. PostgreSQL 7.3← 7.2语法变化

    + HANDLER call_handler [ VALIDATOR valfunction ]正文更新

  23. PostgreSQL 7.2← 7.1语法变化

    + CREATE [ TRUSTED ] [ PROCEDURAL ] LANGUAGE langname− CREATE [ TRUSTED ] [ PROCEDURAL ] LANGUAGE 'langname'− LANCOMPILER 'comment'正文更新

  24. PostgreSQL 7.1← 7.0语法变化

    sql-createlanguage.htm → sql-createlanguage.html

    + CREATE [ TRUSTED ] [ PROCEDURAL ] LANGUAGE 'langname'正文更新

  25. PostgreSQL 7.0← 6.5正文更新

    正文更新

  26. PostgreSQL 6.5← 6.4正文更新

    正文更新

同组命令

命令动词对象版本变动最近变更
FUNCTIONS & PROCEDURES函数与过程18 条↑
CALLCALL— —
调用一个过程现存
DODO— —
执行匿名代码块现存
CREATE AGGREGATECREATEAGGREGATE 1911 次
定义一个新的聚合函数现存
ALTER AGGREGATEALTERAGGREGATE 147 次
更改一个聚合函数的定义现存
DROP AGGREGATEDROPAGGREGATE 106 次
移除一个聚合函数现存
CREATE FUNCTIONCREATEFUNCTION 1416 次
定义一个新函数现存
ALTER FUNCTIONALTERFUNCTION 1411 次
更改函数的定义现存
DROP FUNCTIONDROPFUNCTION 104 次
移除一个函数现存
CREATE LANGUAGECREATELANGUAGE 137 次
定义一种新的过程语言现存
ALTER LANGUAGEALTERLANGUAGE 144 次
更改一种过程语言的定义现存
DROP LANGUAGEDROPLANGUAGE 8.25 次
移除一种过程语言现存
CREATE PROCEDURECREATEPROCEDURE 141 次
定义一个新过程现存
ALTER PROCEDUREALTERPROCEDURE 142 次
更改过程的定义现存
DROP PROCEDUREDROPPROCEDURE —
移除一个过程现存
ALTER ROUTINEALTERROUTINE 142 次
更改一个例程的定义现存
DROP ROUTINEDROPROUTINE —
移除一个例程现存
CREATE TRANSFORMCREATETRANSFORM 101 次
定义一个新的转换现存
DROP TRANSFORMDROPTRANSFORM 9.61 次
移除一个转换现存