ECPG 并不直接支持大对象,在调用ECPGget_PGconn()
函数获得所需的PGconn
对象后,ECPG 应用能通过 libpq 大对象函数操纵大对象(不过,对ECPGget_PGconn()
函数的使用以及直接接触PGconn
对象都必须非常小心,并且最好不要与其他 ECPG 数据库访问调用混合在一起)。
更多关于ECPGget_PGconn()
的细节可见Section 36.11。大对象函数接口的相关信息可见Chapter 35。
大对象函数必须在一个事务块中被调用,因此当自动提交关闭时,必须显式地发出BEGIN
命令。
Example 36.2给出了一个例子程序,它展示了在一个 ECPG 应用中如何创建、写入和读取一个大对象。
Example 36.2. 访问大对象的 ECPG 程序
#include <stdio.h> #include <stdlib.h> #include <libpq-fe.h> #include <libpq/libpq-fs.h> EXEC SQL WHENEVER SQLERROR STOP; int main(void) { PGconn *conn; Oid loid; int fd; char buf[256]; int buflen = 256; char buf2[256]; int rc; memset(buf, 1, buflen); EXEC SQL CONNECT TO testdb AS con1; EXEC SQL SELECT pg_catalog.set_config('search_path', '', false); EXEC SQL COMMIT; conn = ECPGget_PGconn("con1"); printf("conn = %p\n", conn); /* 创建 */ loid = lo_create(conn, 0); if (loid < 0) printf("lo_create() failed: %s", PQerrorMessage(conn)); printf("loid = %d\n", loid); /* 写入测试 */ fd = lo_open(conn, loid, INV_READ|INV_WRITE); if (fd < 0) printf("lo_open() failed: %s", PQerrorMessage(conn)); printf("fd = %d\n", fd); rc = lo_write(conn, fd, buf, buflen); if (rc < 0) printf("lo_write() failed\n"); rc = lo_close(conn, fd); if (rc < 0) printf("lo_close() failed: %s", PQerrorMessage(conn)); /* 读取测试 */ fd = lo_open(conn, loid, INV_READ); if (fd < 0) printf("lo_open() failed: %s", PQerrorMessage(conn)); printf("fd = %d\n", fd); rc = lo_read(conn, fd, buf2, buflen); if (rc < 0) printf("lo_read() failed\n"); rc = lo_close(conn, fd); if (rc < 0) printf("lo_close() failed: %s", PQerrorMessage(conn)); /* 检查 */ rc = memcmp(buf, buf2, buflen); printf("memcmp() = %d\n", rc); /* 清理 */ rc = lo_unlink(conn, loid); if (rc < 0) printf("lo_unlink() failed: %s", PQerrorMessage(conn)); EXEC SQL COMMIT; EXEC SQL DISCONNECT ALL; return 0; }