| PostgreSQL 8.3.3문서 | ||||
|---|---|---|---|---|
| Prev | Fast Backward | Chapter 30. Large Objects | Fast Forward | Next |
본 절에서는 PostgreSQL클라이언트 인터페이스 라이브러리에서 제공되는 large object에 관한 기능을 설명합니다.
함수를 사용한 large object의 모든 조작은 SQL 트랜잭션(transaction) 블록 내에서 행해지지
않으면 안됩니다
.
PostgreSQL large object 인터페이스는 Unix 파일 시스템 인터페이스와 연관되어 설계되고 있어
open, read, write, lseek 등 같은 인터페이스를 가지고 있습니다.
libpq의 large object 인터페이스를 사용하는 클라이언트 어플리케이션은 libpq/libpq-fs.h header 파일을 포함해서 libpq라이브러리와 링크해야 합니다.
Oid lo_creat(PGconn *conn, int mode);
이 함수는 large object를 새로 생성합니다. 리턴 값은 신규 large object에 포함된 OID로, 실패 시에는 InvalidOid(0)가 반환됩니다. PostgreSQL 8.1에서는 mode 는 사용되지 않고 무시됩니다. 그러나, 전 릴리스와의 backward 호환성을 위해서, INV_READ,INV_WRITE,INV_READ | INV_WRITE로 설정하는 것이 최선입니다. (이러한 상징적인 상수는 libpq/libpq-fs.h header 파일 내에 정의되고 있습니다. )
이하는 예를 나타냅니다.
inv_oid = lo_creat(conn, INV_READ|INV_WRITE);
Oid lo_create(PGconn *conn, Oid lobjId);
이 함수도 large object를 새롭게 생성합니다.
할당된 OID를
lobjId
로 지정할 수 있습니다.
그래서 그 OID가 이미 다른 large object로 사용되고 있을 경우는 실패하게 됩니다.
lobjId
가 InvalidOid(0)의 경우, lo_create는 사용되지 않은 OID를 할당합니다.
(이것은 lo_creat와 같은 동작입니다. )
리턴값은 신규 large object에 할당되었던 OID로, 실패 시에는InvalidOid(0)가 반환되어집니다.
lo_create는 PostgreSQL 8.1으로부터 도입되었습니다.
이 함수가 오래된 서버 버전에서 실행될 경우, 실패할 것이고 InvalidOid가 반환될 것입니다.
예를 나타냅니다.
inv_oid = lo_create(conn, desired_oid);
operating system 파일을 large object로 import하려면, 이하의 함수를 호출합니다.
Oid lo_import(PGconn *conn, const char *filename);
filename 는 large object로서 import되는 파일의 operating system 이름을 지정합니다. 리턴 값은 새로운 large objec에 할당된 OID입니다. 실패 시는 InvalidOid(0)가 반환됩니다. 파일이 서버는 아니고, 클라이언트 인터페이스 라이브러리로부터 읽혀지는 지 주의하십시요. 즉, 이 파일은 클라이언트 파일 시스템에 있어야만하고, 클라이언트 어플리케이션으로부터 읽어질 수 있습니다.
large object를 operating system 파일로 export하려면, 이하의 함수를 호출합니다.
int lo_export(PGconn *conn, Oid lobjId, const char *filename);
lobjId 인자는 export하는 large object의 OID를 지정하고, filename인자는 파일의 operating system 이름을 지정합니다. 이 파일은 서버는 아닌, 클라이언트 인터페이스 라이브러리에 의해 입력되는 것을 주의하십시요. 성공 시에는 1, 실패시에는 ―1이 반환됩니다.
읽거나 입력을 위해 기존의 large object를 여는 경우는, 이하의 함수를 호출합니다.
int lo_open(PGconn *conn, Oid lobjId, int mode);
lobjId인자는 열고 싶은 large object의 OID를 지정합니다.
mode의 각 비트는, 오브젝트를 읽기(INV_READ), 입력(INV_WRITE) 또는 그 둘을 위한 오픈 여부를 제어합니다.
(이러한 상징적 상수는 libpq/libpq-fs.h header 파일 내에서 정의되고 있습니다.)
생성되지 않은 large object는 열 수 없습니다.
lo_open는 lo_read,lo_write,lo_lseek,lo_tell,lo_close로 사용하는(비부의) large object 기술어를 리턴합니다.
이 기술어는 현재의 트랜잭션(transaction) 기간에만 유효합니다.
실패시에는 -1이 돌려주어집니다.
현시점에서는 서버는INV_WRITE모드,INV_READ | INV_WRITE모드를 구별하지 않습니다.
두 경우 모두 기술어로를 사용해야 읽을 수 있습니다.
그러나 이러한 모드와 INV_READ모드 하나 사이에는 명백한 차이가 존재합니다.
INV_READ모드에서는 기술어에 입력을 할 수 없습니다.
그리고 읽어들인 데이터는 트랜잭션(transaction)이나 다른 트랜잭션(transaction)에 의해 입력된 다음인지와 관계없이
lo_open를 실행했을 때 유효했던 트랜잭션(transaction) snapshot 시점의 large object의 내용을 반영할 것입니다.]
INV_WRITE를 가진 오픈된 기술어로부터 읽어내면, 현재의 트랜잭션(transaction)에 의한 입력이나 다른 처리된 트랜잭션(transaction)의 모든 입력을 반영한 데이터가 리턴됩니다.
이것은 보통의 SELECT SQL 커멘드를 위한 SERIALIZABLE과 READ COMMITTED트랜잭션(transaction)의 동작의 차이와 비슷합니다.
이하에 예를 나타냅니다.
inv_fd = lo_open(conn, inv_oid, INV_READ|INV_WRITE);
int lo_write(PGconn *conn, int fd, const char *buf, size_t len);
는 buf로부터 len바이트를 fd large object 기술어에 입력된다.
fd인자는 사전에 실행한 lo_open의 반환값이 아니면 안됩니다.
실제로 입력된 바이트 수가 돌려주어집니다.
에러가 발생했을 경우는, 음의 값을 돌려줍니다.
int lo_read(PGconn *conn, int fd, char *buf, size_t len);
함수는 len 바이트를 fd large object 기술어로부터 buf에 읽어들입니다.
fd인자는 사전에 실행한 lo_open의 반환값이 아니면 안됩니다.
실제로 읽어 들인 바이트 수가 돌려주어집니다.
에러가 발생했을 경우는, 음의 값을 돌려줍니다.
large object 기술어와 관련된 현재 읽어들이거나 입력하는 위치를 변경하기 위해서, 다음의 함수를 호출합니다.
int lo_lseek(PGconn *conn, int fd, int offset, int whence);
함수는 fd로 식별되는 large object 기술어의 현재 위치를 가리키는 포인터를, offset로 지정된 새로운 위치로 변경시킵니다. whence로 지정 가능한 값은, SEEK_SET(오브젝트 시작부터 검색), SEEK_CUR(현재 위치부터 검색), SEEK_END(오브젝트 아래부터 검색)입니다. 반환값은 새로운 위치 포인터로, 에러 시에 -1이 돌려주어집니다.
Large Object 기술어의 읽혀지고 입력되는 현재 위치를 얻기 위해서, 이하의 함수를 호출합니다.
int lo_tell(PGconn *conn, int fd);
이하를 호출하는 것으로 large object 기술어를 종료할 수 있습니다.
int lo_close(PGconn *conn, int fd);
여기서, fd는 lo_open의 반환값인 large object 기술어입니다.
성공하면 lo_close는 0을 돌려줍니다.
실패하면 음의 값을 돌려줍니다.
오픈된 상태인 large object 기술어는 모두 트랜잭션(transaction)의 종료 시에 자동적으로 닫힙니다.
데이터베이스로부터 Large Object를 삭제하려면, 이하의 함수를 호출합니다.
int lo_unlink(PGconn *conn, Oid lobjId);
lobjId인자는 삭제하는 large object의 OID를 지정합니다. 성공시에 1을, 실패시에 -1을 돌려줍니다.