pg_orphaned
处理孤儿文件的扩展插件
仓库
bdrouvot/pg_orphaned
https://github.com/bdrouvot/pg_orphaned
源码
pg_orphaned-1.0.tar.gz
pg_orphaned-1.0.tar.gz
概览
| 扩展包名 | 版本 | 分类 | 许可证 | 语言 |
|---|---|---|---|---|
pg_orphaned | 1.0 | ADMIN | PostgreSQL | C |
| ID | 扩展名 | Bin | Lib | Load | Create | Trust | Reloc | 模式 |
|---|---|---|---|---|---|---|---|---|
| 5200 | pg_orphaned | 否 | 是 | 否 | 是 | 否 | 否 | - |
| 相关扩展 | pg_dirtyread pg_surgery amcheck pageinspect pg_visibility pg_checksums pg_catcheck pg_repack |
|---|
版本
| 类型 | 仓库 | 版本 | PG 大版本 | 包名 | 依赖 |
|---|---|---|---|---|---|
| EXT | PIGSTY | 1.0 | 1817161514 | pg_orphaned | - |
| RPM | PIGSTY | 1.0 | 1817161514 | pg_orphaned_$v | - |
| DEB | PIGSTY | 1.0 | 1817161514 | postgresql-$v-pg-orphaned | - |
构建
您可以使用 pig build 命令构建 pg_orphaned 扩展的 RPM / DEB 包：
pig build pkg pg_orphaned # 构建 RPM / DEB 包
安装
您可以直接安装 pg_orphaned 扩展包的预置二进制包，首先确保 PGDG 和 PIGSTY 仓库已经添加并启用：
pig repo add pgsql -u # 添加仓库并更新缓存
使用 pig 或者是 apt/yum/dnf 安装扩展：
pig install pg_orphaned; # 当前活跃 PG 版本安装
pig ext install -y pg_orphaned -v 18 # PG 18
pig ext install -y pg_orphaned -v 17 # PG 17
pig ext install -y pg_orphaned -v 16 # PG 16
pig ext install -y pg_orphaned -v 15 # PG 15
pig ext install -y pg_orphaned -v 14 # PG 14
dnf install -y pg_orphaned_18 # PG 18
dnf install -y pg_orphaned_17 # PG 17
dnf install -y pg_orphaned_16 # PG 16
dnf install -y pg_orphaned_15 # PG 15
dnf install -y pg_orphaned_14 # PG 14
apt install -y postgresql-18-pg-orphaned # PG 18
apt install -y postgresql-17-pg-orphaned # PG 17
apt install -y postgresql-16-pg-orphaned # PG 16
apt install -y postgresql-15-pg-orphaned # PG 15
apt install -y postgresql-14-pg-orphaned # PG 14
创建扩展：
CREATE EXTENSION pg_orphaned;
用法
pg_orphaned 提供检测和管理 PostgreSQL 中孤立数据文件的函数。它通过使用脏快照处理进行中的事务可能导致误报的边角情况。
列出孤立文件
-- 列出孤立文件（默认：超过 1 天的标记为 "older"）
SELECT * FROM pg_list_orphaned();
-- 自定义时间阈值
SELECT * FROM pg_list_orphaned('10 seconds');
SELECT * FROM pg_list_orphaned('1 minute');
返回：dbname、path、name、size、mod_time、relfilenode、reloid、older（布尔值）。
将孤立文件移至备份
-- 将超过阈值的文件移动到 orphaned_backup 目录
SELECT pg_move_orphaned('1 minute');
列出已移动的文件
SELECT * FROM pg_list_orphaned_moved();
将文件移回（如果仍然是孤立的）
SELECT pg_move_back_orphaned();
删除已移动的文件
SELECT pg_remove_moved_orphaned();
典型工作流程
-- 1. 检查孤立文件
SELECT * FROM pg_list_orphaned('1 minute');
-- 2. 将它们移到备份（仅超过阈值的）
SELECT pg_move_orphaned('1 minute');
-- 3. 验证移动了什么
SELECT * FROM pg_list_orphaned_moved();
-- 4. 确认后删除备份文件
SELECT pg_remove_moved_orphaned();
注意：函数操作的是你当前连接的数据库中的孤立文件。在移动或删除文件前请务必仔细检查。