external_file
通过 PostgreSQL 函数访问服务器端外部文件
仓库
darold/external_file
https://github.com/darold/external_file
源码
external_file-1.2.tar.gz
external_file-1.2.tar.gz
概览
| 扩展包名 | 版本 | 分类 | 许可证 | 语言 |
|---|---|---|---|---|
external_file | 1.2 | UTIL | PostgreSQL | SQL |
| ID | 扩展名 | Bin | Lib | Load | Create | Trust | Reloc | 模式 |
|---|---|---|---|---|---|---|---|---|
| 4285 | external_file | 否 | 否 | 否 | 是 | 否 | 否 | external_file |
Fixed schema external_file; superuser required.
版本
| 类型 | 仓库 | 版本 | PG 大版本 | 包名 | 依赖 |
|---|---|---|---|---|---|
| EXT | PIGSTY | 1.2 | 1817161514 | external_file | - |
| RPM | PIGSTY | 1.2 | 1817161514 | external_file_$v | - |
| DEB | PIGSTY | 1.2 | 1817161514 | postgresql-$v-external-file | - |
构建
您可以使用 pig build 命令构建 external_file 扩展的 RPM / DEB 包：
pig build pkg external_file # 构建 RPM / DEB 包
安装
您可以直接安装 external_file 扩展包的预置二进制包，首先确保 PGDG 和 PIGSTY 仓库已经添加并启用：
pig repo add pgsql -u # 添加仓库并更新缓存
使用 pig 或者是 apt/yum/dnf 安装扩展：
pig install external_file; # 当前活跃 PG 版本安装
pig ext install -y external_file -v 18 # PG 18
pig ext install -y external_file -v 17 # PG 17
pig ext install -y external_file -v 16 # PG 16
pig ext install -y external_file -v 15 # PG 15
pig ext install -y external_file -v 14 # PG 14
dnf install -y external_file_18 # PG 18
dnf install -y external_file_17 # PG 17
dnf install -y external_file_16 # PG 16
dnf install -y external_file_15 # PG 15
dnf install -y external_file_14 # PG 14
apt install -y postgresql-18-external-file # PG 18
apt install -y postgresql-17-external-file # PG 17
apt install -y postgresql-16-external-file # PG 16
apt install -y postgresql-15-external-file # PG 15
apt install -y postgresql-14-external-file # PG 14
创建扩展：
CREATE EXTENSION external_file;
用法
external_file 将文件定位符存储为 (directory, filename) 对，并通过 PostgreSQL lo_* 辅助函数访问服务器端文件，而不是直接读取文件。
基本流程
CREATE EXTENSION external_file;
INSERT INTO directories(directory_name, directory_path)
VALUES ('temporary', '/tmp/');
INSERT INTO directory_roles(directory_name, directory_role, directory_read, directory_write)
VALUES ('temporary', 'app_reader', true, false);
SELECT writeEfile('\x48656c6c6f0a', ('temporary', 'hello.txt'));
SELECT readEfile(efilename('temporary', 'hello.txt'));
SELECT copyEfile(('temporary', 'hello.txt'), ('temporary', 'hello-copy.txt'));
核心对象
directories：将别名映射到服务器上的目录路径。directory_roles：为角色授予该别名的读写权限。efilename(directory, filename)：构造一个efile定位符。readEfile(efile)：将目标文件读取为bytea。writeEfile(bytea, efile)：将bytea写入目标文件。copyEfile(src, dest)：将一个外部文件复制到另一个外部文件。getEfilePath(efile, need_read, need_write)：解析完整路径并检查访问权限。
注意事项
- 创建扩展需要 PostgreSQL superuser。
- 上游默认会在
external_fileschema 中创建全部对象。 - PostgreSQL 的 OS user 仍然需要对目标目录具备文件系统读写权限。
- 文件名不能包含
/或\；访问必须通过目录表进行受控中介。