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

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

不受支持的版本: 7.3 / 7.2 / 7.1
历史版本PostgreSQL 7.1 已于 2006 年 4 月结束社区维护,本页译文保留供仍在使用旧版本的读者参考。新系统请看当前版本手册首页。

第 9 章 PyGreSQL - Python 接口

目录

9.1. pg 模块
9.1.1. 常量
9.2. pg 模块函数
connect — 打开到数据库服务器的连接
get_defhost — 获取默认主机名 [DV]
set_defhost — 设置默认主机名 [DV]
get_defport — 获取默认端口 [DV]
set_defport — 设置默认端口 [DV]
get_defopt — 获取默认选项说明 [DV]
set_defopt — 设置默认选项说明 [DV]
get_deftty — 获取默认连接调试终端说明 [DV]
set_deftty — 设置默认连接调试终端说明 [DV]
get_defbase — 获取默认数据库名说明 [DV]
set_defbase — 设置默认数据库名说明 [DV]
9.3. 连接对象:pgobject
query — 执行一条 SQL 命令
reset — 重置连接
close — 关闭数据库连接
fileno — 返回用于连接数据库的套接字
getnotify — 获取来自服务器的最近一次通知
inserttable — 把一个列表插入表中
putline — 向服务器套接字写一行 [DA]
getline — 从服务器套接字读一行 [DA]
endcopy — 同步客户端和服务器 [DA]
locreate — 在数据库中创建一个大对象 [LO]
getlo — 根据给定的 OID 构建一个大对象 [LO]
loimport — 把文件导入为一个 PostgreSQL 大对象 [LO]
9.4. 数据库包装类:DB
pkey — 返回一个表的主键
get_databases — 获取系统中数据库的列表
get_tables — 获取所连接数据库中表的列表
get_attnames — 返回一个表的属性名
get — 从数据库表中获取一个元组
insert — 把一个元组插入数据库表
update — 更新数据库表
clear — 清空数据库表
delete — 从表中删除一行
9.5. 查询结果对象:pgqueryobject
getresult — 获取查询返回的值
dictresult — 以字典列表的形式获取查询返回的值
listfields — 列出查询结果的字段名
fieldname — 按编号获取字段名
fieldnum — 按名称获取字段编号
ntuples — 返回查询对象中的元组数
9.6. 大对象:pglarge
open — 打开大对象
close — 关闭大对象
read — 从大对象读取
write — 写入大对象
seek — 改变大对象中的当前位置
tell — 返回大对象中的当前位置
unlink — 删除大对象
size — 返回大对象的大小
export — 把大对象保存到文件
9.7. DB-API 接口

作者

由 D'Arcy J.M. Cain()编写。 大量基于 Pascal Andre 编写的代码。版权 © 1995, Pascal Andre。进一步的修改版权 © 1997-2000,归 D'Arcy J.M. Cain 所有。

9.1. pg 模块 #

你可以选择使用 pg 模块提供的旧而成熟的接口,也可以使用符合 Python DB-SIG 开发的 DB-API 2.0 规范的较新 pgdb 接口。

这里我们只描述较旧的 pg API。只要 PyGreSQL 还没有收录 DB-API 的描述,你就应该在 http://www.python.org/topics/database/DatabaseAPI-2.0.html 阅读该 API 的说明。

可以在 http://www2.linuxjournal.com/lj-issues/issue49/2605.html 找到一篇 DB-API 的教程式介绍

pg 模块定义了三个对象:

  • pgobject,它处理连接以及对数据库的所有 请求,

  • pglargeobject,它处理对 Postgres 大对象的所有访问,以及

  • pgqueryobject,它处理查询结果。

如果你想看到使用其中一些函数的简单示例,请访问 http://www.druid.net/rides,在那里我 在页面底部放了一个指向该页面实际 Python 代码的链接。

9.1.1. 常量

pg 模块字典中定义了一些常量。它们旨在用作方法 调用的参数。关于它们的更多信息,请参阅 libpq 的描述(第 1 章)。 这些常量是:

INV_READ
INV_WRITE
INV_ARCHIVE

大对象的访问模式,由 (pgobject.)locreate 和 (pglarge.)open 使用。

SEEK_SET
SEEK_CUR
SEEK_END

位置标志,由 (pglarge.)seek 使用。

version
__version__

给出当前版本的常量

提交更正

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