PostgreSQL7.0手冊-接口-50. 函數 51. 大對象

2019-09-08 23:34:15

字體：大中小

來源：轉載

供稿：網友

第五十章.　函數
用戶可調用的函數的參考．
注意：本節(jié)需要人來寫．愿當支援者嗎？

第五十一章.　大對象
內容　
歷史信息　
實現(xiàn)的特點　
接口　
內建的已注冊函數　
從　LIBPQ　里訪問大對象　
例子程序　
在　Postgres　里，記錄存儲在數據頁面里并且單個記錄里的數據大小不能超過數據頁面的大?。驗閿祿撁娲笮∈恰?192　字節(jié)，所以數據值的大小是相當小的．為了存儲更大的不可分割數值（原子數值），Postgres　提供了大對象接口．這個接口給用戶提供對定義為大對象的用戶數據的面向文件的接口．本節(jié)描述　Postgres　大對象數據的實現(xiàn)，編程和查詢語言接口．　
歷史信息
最初，Postgres　4.2　支持三種大對象的標準實現(xiàn)：作為　Postgres　的文件擴展，作為由　Postgres　管理的　UNIX　文件，以及作為存儲在　Postgres　數據庫里面的數據．這樣做容易導致用戶的迷惑．結果是，我們只支持把大對象作為數據存儲在Postgres　數據庫里，即使這樣做令數據訪問變得有些慢，但卻保證了更嚴格的數據完整性．由于歷史原因，這種存儲機制被稱為倒轉大對象．（我們將在本章中交互使用倒轉和大對象來表示同一個意思）。
--------------------------------------------------------------------------------

實現(xiàn)的特點
倒轉大對象把大對象分解成"塊"　（"chunks"），然后把塊存放在數據庫記錄里面．在隨機讀寫時使用一個B-tree　索引保證對正確的塊（chunk）號的檢索．

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

接口
Postgres　提供的用于訪問大對象的機制，包括作為用戶定義函數的后端的一部分或者作為使用接口的前端應用的一部分，都在下面描述．對于熟悉　Postgres　4.2　的用戶，PostgreSQL　有一套新的函數提供更連貫的接口．　
注意：所有大對象的操作都必須在一個SQL事務里實現(xiàn)。這在　Postgres　v6.5　里有嚴格的要求，盡管在以前的版本里就隱含這樣的要求，如果忽略這一點會導致錯誤的表現(xiàn)。
Postgres　大對象接口是對　UNIX　文件系統(tǒng)的模仿，有仿真的　open(2)，read(2)，write(2)，lseek(2)，等．用戶函數調用這些路徑從一個大對象中檢索她們感興趣的數據．例如，如果一個名為　mugshot　的大對象類型存在，在其中保存面孔的圖象，那么可以在　mugshot　數據上定義一個叫　beard　（胡子）的函數．Beard?。ê雍瘮担z查圖片的下三分之一區(qū)域，并且如果存在胡子的話判斷胡子的顏色．整個大對象的值不需要被　brard　函數緩存起來或者甚至是作些檢查．大對象可以從動態(tài)裝載的　C　函數或者是鏈接該庫的數據庫客戶程序訪問．Postgres　提供一套過程支持對大對象的打開，讀，寫，關閉和搜索?！?
創(chuàng)建大對象
過程　
Oid　lo_creat(PGconn　*conn,　int　mode)
創(chuàng)建一個新的大對象．mode　是一個位掩碼，描述新對象的不同屬性．這里列出的符號常量在　$PGROOT/src/backend/libpq/libpq-fs.h．訪問類型（讀，寫或者兩者）是對位　INV_READ　和　INV_WRITE進行　OR　（或）操作構成的．如果大對象應被歸檔--也就是說，如果因歷史原因它應該被周期地移到一個特殊的歸檔關系（表）中--那么就要設置　INV_ARCHIVE　位．掩碼的低十六位是大對象要存放于內的存儲管理器號．對于除　Berkeley　（伯克利）以外的節(jié)點，這些位都應總是零．下面的命令創(chuàng)建一個（倒轉的）大對象：　
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　文件的路徑名．
打開一個現(xiàn)有的大對象
要打開一個現(xiàn)存的大對象，調用　
int　lo_open(PGconn　*conn,　Oid　lobjId,　int　mode)
參數　lobjId　指明要打開的大對象的　Oid?。▽ο髽俗R）．mode　位控制該對象是用于讀（INV_READ），寫還是讀寫．一個大對象在其創(chuàng)建之前不能被打開．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　字節(jié)．參數　fd　必須是前面一個　lo_open　的返回．返回實際寫的字節(jié)數．出錯時返回負數．
從大對象中讀取數據
過程　
int　lo_read(PGconn　*conn,　int　fd,　char　*buf,　size_t　len)
從大對象中讀取　len　字節(jié)數據到　buf　中。fd　參數必須是前面的一個　lo_open　調用的返回。返回實際讀取的字節(jié)數。出錯時，返回一個負數。
對大對象中數據的查找
要改變當前大對象的讀或寫位置，調用　
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
　　　　WHERE　name　=　'beautiful　image';

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

通過　LIBPQ　訪問大對象
下面是一個例子程序，顯示如何使用　LIBPQ　里大對象接口的．程序的一部分是注釋掉的，但仍然保留在源碼里面供讀者參考．這個程序可以在　../src/test/examples　里找到．使用　LIBPQ　里大對象接口的前端應用應該包括頭文件libpq/libpq-fs.h　并且聯(lián)接　libpq　庫．

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

例子程序
/*--------------------------------------------------------------
　*
　*　testlo.c--
　*　　　　test　using　large　objects　with　libpq
　*
　*　Copyright　(c)　1994,　Regents　of　the　University　of　California
　*
　*
　*　IDENTIFICATION
　*　　　　/usr/local/devel/pglite/cvs/src/doc/manual.me,v　1.16　1995/09/01　23:55:00　jolly　Exp
　*
　*--------------------------------------------------------------
　*/
#include　
#include　"libpq-fe.h"
#include　"libpq/libpq-fs.h"

#define　BUFSIZE　　　　　　　　　　1024

/*
　*　importFile　*　　　　import　file　"in_filename"　into　database　as　large　object　"lobjOid"
　*
　*/
Oid　importFile(PGconn　*conn,　char　*filename)
{
　　　　Oid　lobjId;
　　　　int　lobj_fd;
　　　　char　buf[BUFSIZE];
　　　　int　nbytes,　tmp;
　　　　int　fd;

　　　　/*
　　　　　*　open　the　file　to　be　read　in
　　　　　*/
　　　　fd　=　open(filename,　O_RDONLY,　0666);
　　　　if　(fd　<　0)　　{　　　/*　error　*/
　　　　　fprintf(stderr,　"can't　open　unix　file　%s/n",　filename);
　　　　}

　　　　/*
　　　　　*　create　the　large　object
　　　　　*/
　　　　lobjId　=　lo_creat(conn,　INV_READ|INV_WRITE);
　　　　if　(lobjId　==　0)　{
　　　　　fprintf(stderr,　"can't　create　large　object/n");
　　　　}

　　　　lobj_fd　=　lo_open(conn,　lobjId,　INV_WRITE);
　　　　/*
　　　　　*　read　in　from　the　Unix　file　and　write　to　the　inversion　file
　　　　　*/
　　　　while　((nbytes　=　read(fd,　buf,　BUFSIZE))　>　0)　{
　　　　　tmp　=　lo_write(conn,　lobj_fd,　buf,　nbytes);
　　　　　if　(tmp　<　nbytes)　{
　　　　　　　　　fprintf(stderr,　"error　while　reading　large　object/n");
　　　　　}
　　　　}

　　　　(void)　close(fd);
　　　　(void)　lo_close(conn,　lobj_fd);

　　　　return　lobjId;
}

void　pickout(PGconn　*conn,　Oid　lobjId,　int　start,　int　len)
{
　　　　int　lobj_fd;
　　　　char*　buf;
　　　　int　nbytes;
　　　　int　nread;

　　　　lobj_fd　=　lo_open(conn,　lobjId,　INV_READ);
　　　　if　(lobj_fd　<　0)　{
　　　　　fprintf(stderr,"can't　open　large　object　%d/n",
　　　　　　　　　　lobjId);
　　　　}

　　　　lo_lseek(conn,　lobj_fd,　start,　SEEK_SET);
　　　　buf　=　malloc(len+1);

　　　　nread　=　0;
　　　　while　(len　-　nread　>　0)　{
　　　　　nbytes　=　lo_read(conn,　lobj_fd,　buf,　len　-　nread);
　　　　　buf[nbytes]　=　'　';
　　　　　fprintf(stderr,">>>　%s",　buf);
　　　　　nread　+=　nbytes;
　　　　}
　　　　fprintf(stderr,"/n");
　　　　lo_close(conn,　lobj_fd);
}

void　overwrite(PGconn　*conn,　Oid　lobjId,　int　start,　int　len)
{
　　　　int　lobj_fd;
　　　　char*　buf;
　　　　int　nbytes;
　　　　int　nwritten;
　　　　int　i;

　　　　lobj_fd　=　lo_open(conn,　lobjId,　INV_READ);
　　　　if　(lobj_fd　<　0)　{
　　　　　fprintf(stderr,"can't　open　large　object　%d/n",
　　　　　　　　　　lobjId);
　　　　}

　　　　lo_lseek(conn,　lobj_fd,　start,　SEEK_SET);
　　　　buf　=　malloc(len+1);

　　　　for　(i=0;i　　　　　buf　=　'X';
　　　　buf　=　'　';

　　　　nwritten　=　0;
　　　　while　(len　-　nwritten　>　0)　{
　　　　　nbytes　=　lo_write(conn,　lobj_fd,　buf　+　nwritten,　len　-　nwritten);
　　　　　nwritten　+=　nbytes;
　　　　}
　　　　fprintf(stderr,"/n");
　　　　lo_close(conn,　lobj_fd);
}

/*
　*　exportFile　*　　　　export　large　object　"lobjOid"　to　file　"out_filename"
　*
　*/
void　exportFile(PGconn　*conn,　Oid　lobjId,　char　*filename)
{
　　　　int　lobj_fd;
　　　　char　buf[BUFSIZE];
　　　　int　nbytes,　tmp;
　　　　int　fd;

　　　　/*
　　　　　*　create　an　inversion　"object"
　　　　　*/
　　　　lobj_fd　=　lo_open(conn,　lobjId,　INV_READ);
　　　　if　(lobj_fd　<　0)　{
　　　　　fprintf(stderr,"can't　open　large　object　%d/n",
　　　　　　　　　　lobjId);
　　　　}

　　　　/*
　　　　　*　open　the　file　to　be　written　to
　　　　　*/
　　　　fd　=　open(filename,　O_CREAT|O_WRONLY,　0666);
　　　　if　(fd　<　0)　　{　　　/*　error　*/
　　　　　fprintf(stderr,　"can't　open　unix　file　%s/n",
　　　　　　　　　　filename);
　　　　}

　　　　/*
　　　　　*　read　in　from　the　Unix　file　and　write　to　the　inversion　file
　　　　　*/
　　　　while　((nbytes　=　lo_read(conn,　lobj_fd,　buf,　BUFSIZE))　>　0)　{
　　　　　tmp　=　write(fd,　buf,　nbytes);
　　　　　　　　if　(tmp　<　nbytes)　{
　　　　　　　　　fprintf(stderr,"error　while　writing　%s/n",
　　　　　　　　　　　　　　filename);
　　　　　}
　　　　}

　　　　(void)　lo_close(conn,　lobj_fd);
　　　　(void)　close(fd);

　　　　return;
}

void
exit_nicely(PGconn*　conn)
{
　　PQfinish(conn);
　　exit(1);
}

int
main(int　argc,　char　**argv)
{
　　　　char　*in_filename,　*out_filename;
　　　　char　*database;
　　　　Oid　lobjOid;
　　　　PGconn　*conn;
　　　　PGresult　*res;

　　　　if　(argc　!=　4)　{
　　　　　fprintf(stderr,　"Usage:　%s　database_name　in_filename　out_filename/n",
　　　　　　　　　　argv[0]);
　　　　　exit(1);
　　　　}

　　　　database　=　argv[1];
　　　　in_filename　=　argv[2];
　　　　out_filename　=　argv[3];

　　　　/*
　　　　　*　set　up　the　connection
　　　　　*/
　　　　conn　=　PQsetdb(NULL,　NULL,　NULL,　NULL,　database);

　　　　/*　check　to　see　that　the　backend　connection　was　successfully　made　*/
　　　　if　(PQstatus(conn)　==　CONNECTION_BAD)　{
　　　　　fprintf(stderr,"Connection　to　database　'%s'　failed./n",　database);
　　　　　fprintf(stderr,"%s",PQerrorMessage(conn));
　　　　　exit_nicely(conn);
　　　　}

　　　　res　=　PQexec(conn,　"begin");
　　　　PQclear(res);

　　　　printf("importing　file　%s/n",　in_filename);
/*　　lobjOid　=　importFile(conn,　in_filename);　*/
　　　　lobjOid　=　lo_import(conn,　in_filename);
/*
　　　　printf("as　large　object　%d./n",　lobjOid);

　　　　printf("picking　out　bytes　1000-2000　of　the　large　object/n");
　　　　pickout(conn,　lobjOid,　1000,　1000);

　　　　printf("overwriting　bytes　1000-2000　of　the　large　object　with　X's/n");
　　　　overwrite(conn,　lobjOid,　1000,　1000);
*/

　　　　printf("exporting　large　object　to　file　%s/n",　out_filename);
/*　　　　exportFile(conn,　lobjOid,　out_filename);　*/
　　　　lo_export(conn,　lobjOid,out_filename);

　　　　res　=　PQexec(conn,　"end");
　　　　PQclear(res);
　　　　PQfinish(conn);
　　　　exit(0);
}

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

上一篇：PostgreSQL7.0手冊-接口-52. ecpg - 在 C 里嵌入 SQL

下一篇：PostgreSQL7.0手冊-程序員手冊 -49. 過程語言

發(fā)表評論 共有條評論

用戶名: 密碼:

驗證碼: 匿名發(fā)表

學習交流

更多

ipad mini升級ios8.1卡不卡 ip

上北下南看主板:談主板南北橋

淺談數碼相機照片發(fā)灰的問題
前幾天，化名“夭”的朋友在攝影論壇發(fā)帖，反映用數碼機拍攝的照...

usb無線網卡怎么用,小編告訴你安裝教程09-10

usb調試在哪,小編告訴你usb調試在哪09-10

優(yōu)盤不顯示,小編告訴你優(yōu)盤不顯示怎么辦09-10

低級格式化,小編告訴你硬盤怎么低級格式化09-10

帝國cms分類信息的所在地在的修改09-08

將網站地圖和友情鏈接table樣式改為div+css09-08

用帝國cms實現(xiàn)不規(guī)則新聞或信息調用（應大站09-08

帝國調用DZ論壇精華帖09-08

用靈動標簽調用discuz和phpwind的最新貼子09-08

熱門圖片

更多

芭蕾舞蹈表演，真實美到極致

下午茶時間，悠然自得的休憩

充斥這繁華奢靡氣息的城市迪拜風景圖片

從山間到田野再到大海美麗的自然風景圖片

肉食主義者的最愛美食烤肉圖片

夏日甜心草莓美食圖片

人逢知己千杯少，喝酒搞笑圖集

搞笑試卷，學生惡搞答題

猜你喜歡的新聞

滴滴英文服務上線兩周年用戶已超200萬

華為推出全球至快AI訓練集群Atlas900

馬斯克：特斯拉正組建中國技術團隊

10年后6G將問世速度有望比5G快100倍

WeworkCEO稱已開始考慮未來職位不排除放棄

谷歌軟件商店模式變革：推出5美元會員可用數

華為否認有意收購Oi或其他巴西運營商

武漢發(fā)放首批自動駕駛商用牌照百度等三家

迪士尼CEO伊格爾：曾準備收購推特，但后來放棄

網易網盤11月30日關閉獨立入口第三方賬號

猜你喜歡的關注

PostgreSQL7.0手冊-程序員手冊 -47. 觸發(fā)器

PostgreSql服務器的配置

PostgreSQL7.0手冊-程序員手冊 -49. 過程語

PostgreSQL7.0手冊-程序員手冊 -48. 服務器

PostgreSQL7.0手冊-接口-52. ecpg - 在 C

PostgreSQL7.0手冊-接口-50. 函數 51. 大對

PostgreSQL7.0手冊-接口-54. libpq - C++

PostgreSQL7.0手冊-接口-53. libpq - C 庫

PostgreSQL7.0手冊-接口-56. libpgeasy -

PostgreSQL7.0手冊-接口-55. pgtcl - TCL

新聞熱點

滴滴英文服務上線兩周年用戶已超200萬

2019-09-26 08:57:12

華為推出全球至快AI訓練集群Atlas900

2019-09-25 08:46:36

馬斯克：特斯拉正組建中國技術團隊

2019-09-25 08:15:43

10年后6G將問世速度有望比5G快100倍

2019-09-25 08:12:18

WeworkCEO稱已開始考慮未來職位不排除放棄CEO一職

2019-09-24 08:22:58

谷歌軟件商店模式變革：推出5美元會員可用數百個軟件

2019-09-24 08:07:08

疑難解答

淺談數碼相機照片發(fā)灰的問題

如何能用數碼相機拍出很好的夜景相片

CMOS傳感器介紹

常常忽略的重點論數碼相機的保養(yǎng)

金山快盤云存儲

什么是冷CCD？

Microsoft微軟Xbox360Kinect工作原理

Musiland樂之邦HP11耳機放大器測評報告

MP3完全維修圖文解讀寶典

MP3維修基礎知識

圖片精選

網友關注

u盤無法識別怎么辦,小編告訴你U盤無法識別怎

usb無線網卡怎么用,小編告訴你安裝教程

usb調試在哪,小編告訴你usb調試在哪

優(yōu)盤不顯示,小編告訴你優(yōu)盤不顯示怎么辦

低級格式化,小編告訴你硬盤怎么低級格式化

分區(qū)表丟失,小編告訴你分區(qū)表丟失如何修復

進入bios,小編告訴你戴爾筆記本進入bios設置u

怎么刷bios,小編告訴你華碩怎么刷bios

讀卡器怎么用,小編告訴你如何使用讀卡器

bios升級,小編告訴你華碩主板bios怎么升級