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 (< darcy@druid.net > ) 写作．是参照 Pascal Andre < andre@chimay.via.ecp.fr > 写的代码写作的． 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 模块定义类三个对象∶

pgobject ，它处理联接和所有提交给数据库的请求，
pglargeobject ，它处理所有对 PostgreSQL 大对象的访问．
pgqueryobject 处理查询结果．

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

9.1.1. 常量

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

INV_READ INV_WRITE: 大对象访问模式，用于 (pgobject.)locreate 和 (pglarge.)open ．
SEEK_SET SEEK_CUR SEEK_END: 位置标志，用于 (pglarge.)seek ．
version __version__: 给出当前版本的常量

Chapter 9. PyGreSQL - Python 接口

9.1. pg 模块

9.1.1. 常量

9.1. `pg` 模块