adminpack
PostgreSQL 管理函数集合
仓库
https://www.postgresql.org/docs/16/adminpack.html
https://www.postgresql.org/docs/16/adminpack.html
概览
| 扩展包名 | 版本 | 分类 | 许可证 | 语言 |
|---|---|---|---|---|
adminpack | 2.1 | ADMIN | PostgreSQL | C |
| ID | 扩展名 | Bin | Lib | Load | Create | Trust | Reloc | 模式 |
|---|---|---|---|---|---|---|---|---|
| 5970 | adminpack | 否 | 是 | 否 | 是 | 否 | 否 | - |
| 相关扩展 | fio lo file_fdw ddlx pgdd pg_catcheck pg_cheat_funcs pg_repack |
|---|
版本
| PG18 | PG17 | PG16 | PG15 | PG14 |
|---|---|---|---|---|
| ✗ | ✗ | 2.1 | 2.1 | 2.1 |
安装
提示：这是 PostgreSQL 内核自带的 contrib 扩展
CREATE EXTENSION adminpack;
用法
adminpack 扩展提供服务器端文件管理和日志访问函数，主要由 pgAdmin 和其他管理工具使用。所有函数默认仅限超级用户使用。
文件操作
-- 将文本写入文件（append=false: 文件必须不存在；append=true: 追加）
SELECT pg_file_write('/tmp/test.txt', 'Hello World', false); -- 返回写入的字节数
-- 追加到已有文件
SELECT pg_file_write('/tmp/test.txt', E'\nMore data', true);
-- 将文件同步到磁盘
SELECT pg_file_sync('/tmp/test.txt');
-- 重命名文件
SELECT pg_file_rename('/tmp/old.txt', '/tmp/new.txt');
-- 带归档的重命名（先将已有的 newname 移至归档）
SELECT pg_file_rename('/tmp/old.txt', '/tmp/new.txt', '/tmp/archive.txt');
-- 删除文件
SELECT pg_file_unlink('/tmp/test.txt'); -- 成功返回 true
日志文件访问
-- 列出服务器日志文件（需要默认的 log_filename 格式）
SELECT * FROM pg_logdir_ls();
返回 log_directory 中日志文件的时间戳和路径。
函数参考
| 函数 | 返回 | 描述 |
|---|---|---|
pg_file_write(filename, data, append) | bigint | 将文本写入文件；返回写入的字节数 |
pg_file_sync(filename) | void | 将文件或目录刷写到磁盘 |
pg_file_rename(old, new [, archive]) | boolean | 重命名文件，可选归档已有目标 |
pg_file_unlink(filename) | boolean | 删除文件 |
pg_logdir_ls() | setof record | 列出带时间戳的日志文件 |
访问控制
- 所有函数默认仅限超级用户访问
- 可以通过
GRANT将权限授予非超级用户 - 文件访问限制在数据库集群目录内，除非用户拥有
pg_read_server_files或pg_write_server_files角色
注意：adminpack 已在 PostgreSQL 17 中移除。仅适用于 PostgreSQL 16 及更早版本。