Chapter 9. PyGreSQL - Python 接口

Table of Contents
9.1. pg 模块
9.2. pg 模块函数
联接 — 打开一个与数据库服务器的联接
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 — 类似 getresult 但是返回一个字典列表
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 写的代码写作的. Copyright © 1995, Pascal Andre. 进一步修改 Copyright © 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 相关的信息.

一个类教程的 DB-API 文档可以在 http://www2.linuxjournal.com/lj-issues/issue49/2605.html 找到.

pg 模块定义类三个对象∶

如果你想看看这些函数中的一些在使用中的例子,参阅 http://www.druid.net/rides,在那里我在页面底端有个链接 指向真正的 Python 代码.

9.1.1. 常量

pg 模块目录里定义了一些常量. 它们是准备用做方法调用的参数.你应该参考 libpq 的描述(Chapter 1) 获取关于它们的更多的信息.这些常量是∶

INV_READ, INV_WRITE, INV_ARCHIVE

大对象访问模式,用于 (pgobject.)locreate(pglarge.)open

SEEK_SET, SEEK_CUR, SEEK_END

位置标志,用于 (pglarge.)seek

version, __version__

给出当前版本的常量