Chapter 4. pgtcl - TCL 绑定库

Table of Contents
4.1. 命令
4.2. 例子
4.3. pgtcl 命令参考信息
pg_connect — 打开一个到后端服务器的联接
pg_disconnect — 关闭一个与后端服务器的联接
pg_conndefaults — 获取关于缺省联接参数的信息
pg_exec — 向后端发送一个查询字串
pg_result — 获取查询结果的信息
pg_select — 逐一处理一个 SELECT 语句的结果
pg_listen — 设置或者改变一个侦听异步 NOTIFY 消息的回调(函数)
pg_lo_creat — 创建一个大对象
pg_lo_open — 打开一个大对象
pg_lo_close — 关闭一个大对象
pg_lo_read — 读取一个大对象
pg_lo_write — 写入一个大对象
pg_lo_lseek — 在一个大对象里定位到某个位置
pg_lo_tell — 返回一个大对象的当前(文件)指针位置
pg_lo_unlink — 删除一个大对象
pg_lo_import — 从一个 Unix 文件输入一个大对象
pg_lo_export — 把一个大对象输出到一个 Unix 文件中去.

pgtcl 是一个用于前端和 Postgres 后端交互的 tcl 包.它把大多数 libpq 库的函数/功能做成可用于 tcl 脚本.

这个包最初是 Jolly Chen 写的.

4.1. 命令

Table 4-1. pgtcl 命令

命令描述
pg_connect打开一个与后端服务器的联接
pg_disconnect关闭一个联接
pg_conndefaults获取联接选项和其他缺省值
pg_exec向后端发送一个查询
pg_result操作查询的结果
pg_select在一个 SELECT 语句的结果上循环(处理)
pg_listen建立一个用于 NOTIFY 消息的回叫
pg_lo_creat创建一个大对象
pg_lo_open打开一个大对象
pg_lo_close关闭一个大对象
pg_lo_read读取一个大对象
pg_lo_write写一个大对象
pg_lo_lseek在一个大对象里搜索一个位置
pg_lo_tell返回一个大对象的当前搜索位置
pg_lo_unlink删除一个大对象
pg_lo_import把一个 Unix 文件输入到一个大对象里
pg_lo_export把一个大对象输出到一个 Unix 文件里

这些命令在后续的页面里将继续深入描述.

pg_lo* 过程都是与 Postgres 大对象特性交互的接口. 这些函数是仿照标准 Unix 文件系统接口的做法设计的. pg_lo*过程应该用于一个 BEGIN/END 事务块里头, 因为 pg_lo_open 返回的文件描述符只是在当前事务中有效. pg_lo_import 和 pg_lo_export 必须在一个 BEGIN/END 事务块里面使用.