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

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
历史版本PostgreSQL 8.4 已于 2014 年 7 月结束社区维护,本页译文保留供仍在使用旧版本的读者参考。新系统请看当前版本。

41.3. 数据库访问 #

PL/Python 语言模块会自动导入一个名为 plpy 的 Python 模块。该模块中的函数和常量在 Python 代码中可以通过 plpy.foo 这样的形式访问。目前 plpy 实现了函数 plpy.debug(msg)、 plpy.log(msg)、 plpy.info(msg)、 plpy.notice(msg)、 plpy.warning(msg)、 plpy.error(msg) 和 plpy.fatal(msg)。 plpy.error 和 plpy.fatal 实际上会抛出一个 Python 异常;如果该异常未被捕获,会传播到调用查询之外,导致当前事务或子事务中止。 raise plpy.ERROR(msg) 和 raise plpy.FATAL(msg) 分别等效于调用 plpy.error 和 plpy.fatal。 其余函数只生成不同优先级别的消息。 特定优先级别的消息是报告给客户端、写入服务器日志还是两者都做,由 log_min_messages 和 client_min_messages 配置变量控制。更多信息见 第 18 章。

此外,plpy 模块提供了两个函数: execute 和 prepare。使用 查询字符串和一个可选的限制参数调用 plpy.execute 会执行该查询,并把结果在一个 结果对象中返回。结果对象模拟了列表或字典对象。可以通过行号和 列名访问结果对象。它还有这些附加方法: nrows 返回查询返回的行数, status 是 SPI_execute() 的返回值。结果对象可以被修改。

例如:

rv = plpy.execute("SELECT * FROM my_table", 5)

会从 my_table 中返回最多 5 行。如果 my_table 有一列名为 my_column, 则可以这样访问它:

foo = rv[i]["my_column"]

第二个函数 plpy.prepare 为查询准备执行计划。 若查询中有参数引用,则它以查询字符串和参数类型列表作为参数。例如:

plan = plpy.prepare("SELECT last_name FROM my_users WHERE first_name = $1", [ "text" ])

text 是你要传给 $1 的变量的 类型。准备好语句之后,使用函数 plpy.execute 运行它:

rv = plpy.execute(plan, [ "name" ], 5)

第三个参数是限制,它是可选的。

当你使用 PL/Python 模块准备一个计划时,该计划会被自动保存。 关于这意味着什么,请阅读 SPI 文档(第 42 章)。为了在函数调用之间有效地利用这一点,需要使用持久存储字典 SD 或 GD(见 第 41.1 节)。例如:

CREATE FUNCTION usesavedplan() RETURNS trigger AS $$
    if SD.has_key("plan"):
        plan = SD["plan"]
    else:
        plan = plpy.prepare("SELECT 1")
        SD["plan"] = plan
    # rest of function
$$ LANGUAGE plpythonu;

提交更正

译文有误、术语不当或页面显示问题,请到译文仓库 pgsty/pgdoc 报告译文问题。 英文原文本身的问题,请在当前版本的对应页面向上游反馈;上游不再修订已结束维护的版本。