PostgreSQL7.0手册-接口-50. 函数 51. 大对象

第五十章.　函数
用户可调用的函数的参考．
注意：本节需要人来写．愿当支援者吗？


第五十一章.　大对象
内容　
历史信息　
实现的特点　
接口　
内建的已注册函数　
从　LIBPQ　里访问大对象　
例子程序　
在　Postgres　里，记录存储在数据页面里并且单个记录里的数据大小不能超过数据页面的大小．因为数据页面大小是　8192　字节，所以数据值的大小是相当小的．为了存储更大的不可分割数值（原子数值），Postgres　提供了大对象接口．这个接口给用户提供对定义为大对象的用户数据的面向文件的接口．本节描述　Postgres　大对象数据的实现，编程和查询语言接口．　
历史信息
最初，Postgres　4.2　支持三种大对象的标准实现：作为　Postgres　的文件扩展，作为由　Postgres　管理的　UNIX　文件，以及作为存储在　Postgres　数据库里面的数据．这样做容易导致用户的迷惑．结果是，我们只支持把大对象作为数据存储在Postgres　数据库里，即使这样做令数据访问变得有些慢，但却保证了更严格的数据完整性．由于历史原因，这种存储机制被称为倒转大对象．（我们将在本章中交互使用倒转和大对象来表示同一个意思）。
--------------------------------------------------------------------------------

实现的特点
倒转大对象把大对象分解成"块"　（"chunks"），然后把块存放在数据库记录里面．在随机读写时使用一个B-tree　索引保证对正确的块（chunk）号的检索．

--------------------------------------------------------------------------------
--------------------------------------------------------------------------------

接口
Postgres　提供的用于访问大对象的机制，包括作为用户定义函数的后端的一部分或者作为使用接口的前端应用的一部分，都在下面描述．对于熟悉　Postgres　4.2　的用户，PostgreSQL　有一套新的函数提供更连贯的接口．　
注意：所有大对象的操作都必须在一个SQL事务里实现。这在　Postgres　v6.5　里有严格的要求，尽管在以前的版本里就隐含这样的要求，如果忽略这一点会导致错误的表现。
Postgres　大对象接口是对　UNIX　文件系统的模仿，有仿真的　open(2)，read(2)，write(2)，lseek(2)，等．用户函数调用这些路径从一个大对象中检索她们感兴趣的数据．例如，如果一个名为　mugshot　的大对象类型存在，在其中保存面孔的图象，那么可以在　mugshot　数据上定义一个叫　beard　（胡子）的函数．Beard　（胡子函数）会检查图片的下三分之一区域，并且如果存在胡子的话判断胡子的颜色．整个大对象的值不需要被　brard　函数缓存起来或者甚至是作些检查．大对象可以从动态装载的　C　函数或者是链接该库的数据库客户程序访问．Postgres　提供一套过程支持对大对象的打开，读，写，关闭和搜索。　
创建大对象
过程　
Oid　lo_creat(PGconn　*conn,　int　mode)
创建一个新的大对象．mode　是一个位掩码，描述新对象的不同属性．这里列出的符号常量在　$PGROOT/src/backend/libpq/libpq-fs.h．访问类型（读，写或者两者）是对位　INV_READ　和　INV_WRITE进行　OR　（或）操作构成的．如果大对象应被归档--也就是说，如果因历史原因它应该被周期地移到一个特殊的归档关系（表）中--那么就要设置　INV_ARCHIVE　位．掩码的低十六位是大对象要存放于内的存储管理器号．对于除　Berkeley　（伯克利）以外的节点，这些位都应总是零．下面的命令创建一个（倒转的）大对象：　
inv_oid　=　lo_creat(INV_READ|INV_WRITE|INV_ARCHIVE);
输入大对象
要把一个　UNIX　文件输入成为大对象，调用　
Oid　lo_import(PGconn　*conn,　const　char　*filename)
filename　参数指明要被输入成为大对象的　UNIX　文件路径名．　
输出大对象
要把一个大对象输出为　UNIX　文件，调用　
int　lo_export(PGconn　*conn,　Oid　lobjId,　const　char　*filename)
lobjId　参数指明要输出的大对象　Oid，filename　参数指明　UNIX　文件的路径名．
打开一个现有的大对象
要打开一个现存的大对象，调用　
int　lo_open(PGconn　*conn,　Oid　lobjId,　int　mode)
参数　lobjId　指明要打开的大对象的　Oid　（对象标识）．mode　位控制该对象是用于读（INV_READ），写还是读写．一个大对象在其创建之前不能被打开．lo_open　返回一个大对象标识用于以后的　lo_read，lo_write，lo_lseek，lo_tell，and　lo_close。
向大对象中写数据
过程　
int　lo_write(PGconn　*conn,　int　fd,　const　char　*buf,　size_t　len)
从　buf　中向大对象　fd　中写　len　字节．参数　fd　必须是前面一个　lo_open　的返回．返回实际写的字节数．出错时返回负数．
从大对象中读取数据
过程　
int　lo_read(PGconn　*conn,　int　fd,　char　*buf,　size_t　len)
从大对象中读取　len　字节数据到　buf　中。fd　参数必须是前面的一个　lo_open　调用的返回。返回实际读取的字节数。出错时，返回一个负数。
对大对象中数据的查找
要改变当前大对象的读或写位置，调用　
int　lo_lseek(PGconn　*conn,　int　fd,　int　offset,　int　whence)
这个过程把当前　fd　代表的大对象位置指针移动到　offset　指明的新的位置．参数　whence　的合法的取值是　SEEK_SET　SEEK_CUR　和　SEEK_END．
关闭一个大对象描述符
可以通过调用　
int　lo_close(PGconn　*conn,　int　fd)
关闭一个大对象，这里　fd　是　lo_open　返回的大对象的描述符．成功时，lo_close　返回零．错误时，返回值是负数．

--------------------------------------------------------------------------------
--------------------------------------------------------------------------------

内建的已注册函数
有两个内建的已注册函数，lo_import　和　lo_export　可以很方便的在　SQL　查询里面使用．下面是一些例子　
CREATE　TABLE　image　(
　　　　name　　　　　　　　　　　　text,
　　　　raster　　　　　　　　　　oid
);

INSERT　INTO　image　(name,　raster)
　　　　VALUES　('beautiful　image',　lo_import('/etc/motd'));

SELECT　lo_export(image.raster,　'/tmp/motd')　from　image