pg_relusage

打印查询引用的表与列

概览

扩展包名版本分类许可证语言
pg_relusage0.0.1STATPostgreSQLC
ID扩展名BinLibLoadCreateTrustReloc模式
6850pg_relusage-
相关扩展pg_freespacemap pg_visibility pgstattuple toastinfo pageinspect pg_buffercache pgfincore old_snapshot

版本

类型仓库版本PG 大版本包名依赖
EXTPIGSTY0.0.11817161514pg_relusage-
RPMPIGSTY0.0.11817161514pg_relusage_$v-
DEBPIGSTY0.0.11817161514postgresql-$v-pg-relusage-
OS / PGPG18PG17PG16PG15PG14
el8.x86_64
el8.aarch64
el9.x86_64
el9.aarch64
el10.x86_64
el10.aarch64
d12.x86_64
d12.aarch64
PIGSTY 0.0.1
PIGSTY 0.0.1
PIGSTY 0.0.1
PIGSTY 0.0.1
PIGSTY 0.0.1
d13.x86_64
PIGSTY 0.0.1
PIGSTY 0.0.1
PIGSTY 0.0.1
PIGSTY 0.0.1
PIGSTY 0.0.1
d13.aarch64
PIGSTY 0.0.1
PIGSTY 0.0.1
PIGSTY 0.0.1
PIGSTY 0.0.1
PIGSTY 0.0.1
u22.x86_64
PIGSTY 0.0.1
PIGSTY 0.0.1
PIGSTY 0.0.1
PIGSTY 0.0.1
PIGSTY 0.0.1
u22.aarch64
PIGSTY 0.0.1
PIGSTY 0.0.1
PIGSTY 0.0.1
PIGSTY 0.0.1
PIGSTY 0.0.1
u24.x86_64
PIGSTY 0.0.1
PIGSTY 0.0.1
PIGSTY 0.0.1
PIGSTY 0.0.1
PIGSTY 0.0.1
u24.aarch64
PIGSTY 0.0.1
PIGSTY 0.0.1
PIGSTY 0.0.1
PIGSTY 0.0.1
PIGSTY 0.0.1

构建

您可以使用 pig build 命令构建 pg_relusage 扩展的 RPM / DEB 包:

pig build pkg pg_relusage         # 构建 RPM / DEB 包

安装

您可以直接安装 pg_relusage 扩展包的预置二进制包,首先确保 PGDGPIGSTY 仓库已经添加并启用:

pig repo add pgsql -u          # 添加仓库并更新缓存

使用 pig 或者是 apt/yum/dnf 安装扩展:

pig install pg_relusage;          # 当前活跃 PG 版本安装
pig ext install -y pg_relusage -v 18  # PG 18
pig ext install -y pg_relusage -v 17  # PG 17
pig ext install -y pg_relusage -v 16  # PG 16
pig ext install -y pg_relusage -v 15  # PG 15
pig ext install -y pg_relusage -v 14  # PG 14
dnf install -y pg_relusage_18       # PG 18
dnf install -y pg_relusage_17       # PG 17
dnf install -y pg_relusage_16       # PG 16
dnf install -y pg_relusage_15       # PG 15
dnf install -y pg_relusage_14       # PG 14
apt install -y postgresql-18-pg-relusage   # PG 18
apt install -y postgresql-17-pg-relusage   # PG 17
apt install -y postgresql-16-pg-relusage   # PG 16
apt install -y postgresql-15-pg-relusage   # PG 15
apt install -y postgresql-14-pg-relusage   # PG 14

预加载配置

shared_preload_libraries = 'pg_relusage';

用法

pg_relusage: 记录 SQL 语句实际使用的关系

pg_relusage 挂钩到查询执行器,记录每个 SQL 语句实际使用的关系(表、视图、索引等)。与语句日志不同,它在视图展开和未使用的连接消除之后报告关系。

工作原理

加载后,每个 SQL 语句会产生一条列出所有引用关系的日志消息:

SELECT * FROM pg_stats LIMIT 1;

产生日志输出:

relations used: pg_stats,pg_statistic,pg_class,pg_attribute,pg_namespace

加载

-- 按会话加载
LOAD 'pg_relusage';

-- 或在 postgresql.conf 中全局配置
shared_preload_libraries = 'pg_relusage'

配置

参数默认值描述
pg_relusage.log_levelLOG关系消息的日志级别
pg_relusage.rel_kinds'riSvmfp'要报告的关系类型(来自 pg_class.relkind 的单字母代码)

关系类型代码:r = 表,i = 索引,S = 序列,v = 视图,m = 物化视图,f = 外部表,p = 分区表。

使用场景

该扩展适用于发现遗留数据库中未使用的对象。通过分析一段时间内记录的关系使用情况,可以识别应用程序实际访问了哪些表、视图和索引。


最后修改 2026-03-14: update extension metadata (953cbd0)