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

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

受支持版本: 当前版本 (18) / 17 / 16 / 15 / 14
测试与开发版本: 19 / devel
不受支持的版本: 13 / 12 / 11 / 10 / 9.6 / 9.5 / 9.4 / 9.3 / 9.2 / 9.1 / 9.0 / 8.4 / 8.3 / 8.2 / 8.1 / 8.0 / 7.4 / 7.3 / 7.2
历史版本PostgreSQL 7.4 已于 2010 年 10 月结束社区维护,本页译文保留供仍在使用旧版本的读者参考。新系统请看当前版本。

第 40 章 PL/Python - Python 过程语言

PL/Python 过程语言允许用 Python 语言编写 PostgreSQL 函数。

要在某个特定数据库中安装 PL/Python,使用 createlang plpythonu dbname。

提示

如果把某种语言安装到template1中,随后 创建的所有数据库都会自动安装该语言。

从 PostgreSQL 7.4 起,PL/Python 只能作为 一种“不受信任的”(untrusted)语言使用(这意味着它不 提供任何限制用户能在其中做什么的方法)。因此它已被 改名为 plpythonu。如果将来在 Python 中开发出新的安全执行 机制,受信任的变体 plpython 可能会重新 出现。

注意

源码包的用户必须在安装过程中特别启用 PL/Python 的 构建。(更多信息请参阅 安装说明。)二进制 包的用户可能会在一个单独的子包中找到 PL/Python。

40.1. PL/Python 函数 #

你编写的 Python 代码会被转换成一个 Python 函数。例如,

CREATE FUNCTION myfunc(text) RETURNS text
    AS 'return args[0]'
    LANGUAGE plpythonu;

会被转换成

def __plpython_procedure_myfunc_23456():
        return args[0]

这里假设 23456 是该函数的 OID。

如果你不提供返回值,Python 返回默认的 None。语言模块把 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 报告译文问题。 英文原文本身的问题,请在当前版本的对应页面向上游反馈;上游不再修订已结束维护的版本。