pgsql.cc 提供对 postgresql.org 官网内容的中文翻译,由 Pigsty 团队维护。
PL/Python 过程语言允许用 Python 语言编写 PostgreSQL 函数。
要在某个特定数据库中安装 PL/Python,使用 createlang plpythonu 。dbname
如果把某种语言安装到template1中,之后创建的所有数据库都会自动安装该语言。
从 PostgreSQL 7.4 起,PL/Python 只能作为一种“不受信任的”语言使用(这意味着它不提供任何机制来限制用户能在其中做什么)。因此其名称被改为 plpythonu。如果将来能在 Python 中开发出新的安全执行机制,受信任的变体 plpython 可能会重新出现。
源码包用户必须在安装过程中专门启用 PL/Python 的构建(更多信息请参阅安装说明)。二进制包用户则可能会在单独的子包中找到 PL/Python。
PL/Python 中的函数通过常用的CREATE FUNCTION语法声明。例如:
CREATE FUNCTION myfunc(text) RETURNS text
AS 'return args[0]'
LANGUAGE plpythonu;
作为函数体给出的 Python 代码会被转换成一个 Python 函数。例如,上面的定义会得到
def __plpython_procedure_myfunc_23456():
return args[0]
这里假定 23456 是 PostgreSQL 分配给该函数的 OID。
如果你不提供返回值,Python 会返回默认的 None。PL/Python 会把 Python 的 None 转换为 SQL 空值。
PostgreSQL 函数的参数可以在全局 args 列表中获得。在 myfunc 示例中,args[0] 包含作为 text 参数传入的内容。对于 myfunc2(text, integer),args[0] 将包含 text 参数,args[1] 包含 integer 参数。
全局字典 SD 可用于在函数调用之间存储数据。这个变量是私有的静态数据。 全局字典 GD 是公共数据,同一会话中的所有 Python 函数都可以使用。请谨慎使用。
每个函数在 Python 解释器中都有自己独立的执行环境,因此 myfunc 的全局数据和函数参数对 myfunc2 不可用。例外是上面提到的 GD 字典中的数据。
译文有误、术语不当或页面显示问题,请到译文仓库 pgsty/pgdoc 报告译文问题。 英文原文本身的问题,请在当前版本的对应页面向上游反馈;上游不再修订已结束维护的版本。