pgsql.cc 提供对 postgresql.org 官网内容的中文翻译,由 Pigsty 团队维护。
目录
Postgres 支持定义过程语言。 对于用过程语言定义的函数或触发器过程,数据库 并不内置关于如何解释函数源文本的知识。相反,这项任务会交给 一个了解该语言细节的调用处理器。 调用处理器本身是一个特殊的编程语言函数, 被编译进共享对象并按需装载。
编写新过程语言(PL)的调用处理器超出了本手册的范围。
过程语言的安装
在数据库中安装过程语言需要三个步骤。 (对于标准发行版自带的语言,可以改用 shell 脚本 createlang 来代替手工完成各个细节。)
该语言调用处理器的共享对象必须编译并安装。默认情况下, PL/pgSQL 的调用处理器会被构建并安装到 数据库库目录中。如果配置了 Tcl/Tk 支持, PL/Tcl 的调用处理器也会被构建 并安装到同一位置。
必须用如下命令声明该调用处理器:
CREATE FUNCTIONhandler_function_name() RETURNS OPAQUE AS 'path-to-shared-object' LANGUAGE 'C';
特殊返回类型OPAQUE会告诉数据库系统,该函数返 回的不是某种已定义的SQL数据类型,并且不能在 SQL语句中直接使用。
该 PL 必须用如下命令声明:
CREATE [ TRUSTED ] PROCEDURAL LANGUAGE 'language-name' HANDLERhandler_function_nameLANCOMPILER 'description';
可选关键字 TRUSTED 指明是否允许没有超级用户 权限的普通数据库用户使用该语言创建函数和触发器过程。由于 PL 函数 是在数据库后端内部执行的,TRUSTED 标记只应赋予那些不允许访问数据库后端 内部或文件系统的语言。语言 PL/pgSQL 和 PL/Tcl 已知是受信任的。
示例
下面的命令告诉数据库到哪里查找 PL/pgSQL 语言调用处理器函数的共享对象:
CREATE FUNCTION plpgsql_call_handler () RETURNS OPAQUE AS
'/usr/local/pgsql/lib/plpgsql.so' LANGUAGE 'C';
而命令
CREATE TRUSTED PROCEDURAL LANGUAGE 'plpgsql'
HANDLER plpgsql_call_handler
LANCOMPILER 'PL/pgSQL';
则定义对于语言属性为 'plpgsql' 的函数和触发器过 程,将调用先前声明的调用处理器函数。
PL 调用处理器函数有一个与普通 C 语言函数不同的特殊调用接口。传给 调用处理器的参数之一是要执行的函数在 pg_proc 表条目中的对象 ID。 调用处理器会检查各种系统目录来分析 函数的调用参数及其返回数据类型。函数 主体的源文本位于 pg_proc 的 prosrc 属性中。 因此,PL 函数 可以像 SQL 语言函数一样被重载。只要调用参数不同,就可以有 多个同名的不同 PL 函数。
在 template1 数据库中定义的过程语言会自动在随后创建的所有 数据库中定义。因此数据库管理员可以决定默认 提供哪些语言。
译文有误、术语不当或页面显示问题,请到译文仓库 pgsty/pgdoc 报告译文问题。 英文原文本身的问题,请在当前版本的对应页面向上游反馈;上游不再修订已结束维护的版本。