6.3. 联接对象∶ pgobject

Table of Contents
query — 执行一条 SQL 命令
reset — 重置联接
close — 关闭数据库联接
fileno — 返回用于与数据库联接的套接字.
getnotify — 从服务器获取最后的通知
inserttable — 向一个表插入一个列表
putline — 向服务器套接字写出一行 [DA]
getline — 从服务器套接字获取一行 [DA]
endcopy — 同步客户端和服务器端 [DA]
locreate — 在数据库里创见一个大对象 [LO]
getlo — 从给定的 OID 制作一个大对象[LO]
loimport — 把一个文件输入为一个 PostgreSQL 大对象 [LO]

这个对象控制一次与 PostgreSQL 数据库的联接. 该对象嵌入并隐藏所有定义这次联接的参数,只留下真正重要的参数放在函数调用里面.

有些方法为我们提供了对已联接的套接字的直接访问.这些函数是用 [DA] 标签表示的.除非你清除自给在干什么,否则不要使用这些函数. 如果你原意关闭它们,那么在 Python Setup 文件里设置 -DNO_DIRECT 选项.

还有一些函数给出了对大对象的访问.如果你想从模块里禁止对这些东西 的访问,那么就在PythonSetup 文件里设置 -DNO_LARGE 选项.这些方法用 [LO] 标签标记.

每个 pgobject 定义了一套只读属性,这些属性 描述了联接和它的状态.这些属性是∶

host

服务器的主机名子(字串)

port

服务器的端口(整数)

db

选定的数据库(字串)

options

联接选项(字串)

tty

联接的调试终端(字串)

user

数据库系统的用户名字(字串)

status

联接的状态(整数∶1 - 真确, 0 - 错误)

error

来自服务器的最后的警告/错误(字串)