↑↓ 选择↵ 打开⌫ 切换范围完整搜索

PG.CENTER 连接 PostgreSQL 文档、百科与生态知识。由 Pigsty 维护。

Wiki / SQL 命令

CREATE LANGUAGE

定义一种新的过程语言

英文手册覆盖始于 PostgreSQL 6.4. 来源历史与运行验证各自保留独立版本边界。

当前阅读 PG 18·选择有来源记录的版本

anchor
SQL-CREATELANGUAGE
file
sql-createlanguage.html
lang
en
name
CREATE LANGUAGE
purpose
define a new procedural language
purpose zh
未知
sections same as
未知
slug
18
synopsis text
CREATE [ OR REPLACE ] [ TRUSTED ] [ PROCEDURAL ] LANGUAGE name HANDLER call_handler [ INLINE inline_handler ] [ VALIDATOR valfunction ] 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
语法图

从左向右阅读;分支表示选择,旁路表示可选,循环表示重复。点击带下划线的参数可打开对应规则。

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

版本定义 PG 18

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

描述

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

比较版本

完整来源事实

synopsis html

CREATE [ OR REPLACE ] [ TRUSTED ] [ PROCEDURAL ] LANGUAGE <em class="replaceable"><code>name</code></em>
    HANDLER <em class="replaceable"><code>call_handler</code></em> [ INLINE <em class="replaceable"><code>inline_handler</code></em> ] [ VALIDATOR <em class="replaceable"><code>valfunction</code></em> ]
CREATE [ OR REPLACE ] [ TRUSTED ] [ PROCEDURAL ] LANGUAGE <em class="replaceable"><code>name</code></em>

来源引用

完整定义与证据 JSON

定义来源

center · PostgreSQL 18 · a709ab85

正文语言: zh-Hans · 1b5ca64c