选择 打开 改范围 完整检索页

pgsql.cc 提供对 postgresql.org 官网内容的中文翻译,由 Pigsty 团队维护。

受支持版本: 当前版本 (18) / 17 / 16 / 15 / 14
测试与开发版本: 19 / devel
不受支持的版本: 13 / 12 / 11 / 10 / 9.6 / 9.5 / 9.4 / 9.3 / 9.2 / 9.1 / 9.0
历史版本PostgreSQL 9.6 已于 2021 年 11 月结束社区维护,本页译文保留供仍在使用旧版本的读者参考。新系统请看当前版本

33.4. 服务器端函数 #

专为通过 SQL 操纵大对象而设计的服务器端函数列在表 33.1中。

表 33.1. 面向 SQL 的大对象函数

函数 返回类型 描述 示例 结果
lo_from_bytea(loid oid, string bytea) oid 创建大对象并在其中存储数据,返回其 OID。传入 0 可让系统选择 OID。 lo_from_bytea(0, '\xffffff00') 24528
lo_put(loid oid, offset bigint, str bytea) void 在给定偏移处写入数据。 lo_put(24528, 1, '\xaa')  
lo_get(loid oid [, from bigint, for int]) bytea 提取内容或其中的子串。 lo_get(24528, 0, 3) \xffaaff

前面介绍的每个客户端函数都有对应的服务器端函数;实际上,大多数客户端函数都只是等价服务器端函数的接口。通过 SQL 命令调用起来同样方便的有lo_creatlo_createlo_unlinklo_import以及lo_export。下面是它们的使用示例:

CREATE TABLE image (
    name            text,
    raster          oid
);

SELECT lo_creat(-1);       -- 返回新建的空大对象的 OID

SELECT lo_create(43213);   -- 尝试创建 OID 为 43213 的大对象

SELECT lo_unlink(173454);  -- 删除 OID 为 173454 的大对象

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

INSERT INTO image (name, raster)  -- 与上例相同,但指定要使用的 OID
    VALUES ('beautiful image', lo_import('/etc/motd', 68583));

SELECT lo_export(image.raster, '/tmp/motd') FROM image
    WHERE name = 'beautiful image';

服务器端 lo_importlo_export 函数的行为与客户端对应函数有很大不同。这两个函数使用运行数据库服务器的操作系统用户的权限,读写服务器文件系统中的文件,因此仅限超级用户使用。相比之下,客户端导入和导出函数使用客户端程序的权限,读写客户端文件系统中的文件。客户端函数不要求超级用户权限。

lo_readlo_write的功能也可以通过服务器端调用获得,但服务器端函数名与客户端接口不同,因为它们不包含下划线。必须将这些函数调用为loreadlowrite

提交更正

译文有误、术语不当或页面显示问题,请到译文仓库 pgsty/pgdoc 报告译文问题。 英文原文本身的问题,请在当前版本的对应页面向上游反馈;上游不再修订已结束维护的版本。