PostgreSQL 磁盘占用查看（Table Size / Datafile）

PG 的空间统计函数都返回字节数，配合 pg_size_pretty() 转成 人类可读格式（KB / MB / GB）。表主体文件直接读文件大小，TOAST / 索引部分基于 pg_class.relpages 统计估算，VACUUM / ANALYZE 后 数字更接近实际。

1. 哪个表最占空间（最常用）

SELECT schemaname,
       relname,
       pg_size_pretty(pg_total_relation_size(relid)) AS total_size
FROM pg_stat_user_tables
ORDER BY pg_total_relation_size(relid) DESC
LIMIT 20;

pg_total_relation_size = 表主体 + TOAST + 所有索引， 即这个表真正占用的磁盘总量。

2. 数据库级别

-- 当前数据库
SELECT pg_size_pretty(pg_database_size(current_database()));

-- 所有数据库排序
SELECT datname, pg_size_pretty(pg_database_size(datname)) AS size
FROM pg_database
ORDER BY pg_database_size(datname) DESC;

3. 单表拆解：表 / TOAST / 索引各占多少

TOAST 是什么：TOAST = The Oversized-Attribute Storage Technique （超大属性存储技术）。PG 的行默认不超过一个页面（8KB），当某个字段值 太大时（大 TEXT / BYTEA / 超长 varchar），PG 会先压缩，若仍放不下则 拆分到独立的 TOAST 表（pg_toast_*），原表只留一个指针。 因此大字段数据大多躺在 TOAST 表里，看空间时必须把 TOAST 算进去 （pg_table_size / pg_total_relation_size 已包含），否则会严重低估。 存储策略可调：ALTER TABLE ... SET STORAGE (EXTENDED / EXTERNAL / MAIN / PLAIN)，控制「先压缩还是直接外置」。

SELECT relname,
       pg_size_pretty(pg_relation_size(relid))  AS table_only,   -- 仅表主体
       pg_size_pretty(pg_table_size(relid))     AS with_toast,   -- 表 + TOAST
       pg_size_pretty(pg_indexes_size(relid))   AS indexes,      -- 该表全部索引
       pg_size_pretty(pg_total_relation_size(relid)) AS total
FROM pg_stat_user_tables
ORDER BY pg_total_relation_size(relid) DESC
LIMIT 10;

某个表最占空间的单个索引（表名不在默认 schema 时用 schema.table 限定）：

SELECT c.relname AS index_name,
       pg_size_pretty(pg_relation_size(c.oid)) AS size
FROM pg_class c
JOIN pg_index i ON i.indexrelid = c.oid
WHERE i.indrelid = 'your_table'::regclass
ORDER BY pg_relation_size(c.oid) DESC;

4. 按 Schema 汇总

SELECT schemaname,
       pg_size_pretty(sum(pg_total_relation_size(relid))) AS total
FROM pg_stat_user_tables
GROUP BY schemaname
ORDER BY sum(pg_total_relation_size(relid)) DESC;

5. 数据文件层面（Datafile）

每个表/索引在 $PGDATA/base/<数据库OID>/ 下对应一个 <relfilenode> 文件；超过 1GB 会自动分段为 .1、.2……

-- 表对应的数据文件路径（相对 $PGDATA）
SELECT pg_relation_filepath('your_table');
-- e.g. base/16384/16407

# 在服务器上直接看（$PGDATA 通常需要 postgres 用户权限）
ls -lh $PGDATA/base/16384/16407*      # 含 .1 .2 分段
du -sh $PGDATA/base/16384/            # 该数据库目录总大小

数据库 OID：SELECT oid, datname FROM pg_database; 表的 relfilenode：SELECT relfilenode FROM pg_class WHERE oid = 'your_table'::regclass; 注意 VACUUM FULL / CLUSTER / REINDEX 会改变 relfilenode（旧文件被 替换删除），所以文件名不是稳定的。

6. 空间大 ≠ 数据多：表膨胀（Bloat）

空间占用异常大的常见原因是膨胀：UPDATE/DELETE 留下的死元组没有被 及时回收，表文件里塞满了「已删除但还占着位置」的数据。

• VACUUM：回收死元组空间（块内部复用，文件大小不变，但后续写入可复用）
• VACUUM FULL：重写整表，实际缩小文件（会锁表、耗时，建议低峰执行）
• 排查思路：先 SELECT relname, n_dead_tup FROM pg_stat_user_tables ORDER BY n_dead_tup DESC; 看死元组数量，再决定是否 FULL

一句话总结

flowchart LR
  n0["Database"]
  n1["PostgreSQL 活跃会话诊断（Active Sessions）"]
  n2["PostgreSQL 磁盘占用查看（Table Size / Datafile）"]
  n3["PostgreSQL"]
  n4["PostgreSQL 查看慢查询（Slow Query）"]
  n5["PostgreSQL WAL 与 LSN"]
  n6["Knowledge"]
  n7["Cloud"]
  n8["Infrastructure"]
  n0 --> n3
  n3 --> n1
  n3 --> n2
  n3 --> n4
  n3 --> n5
  n4 --> n1
  n6 --> n0
  n6 --> n8
  n8 --> n7
  click n0 "../../" "Database"
  click n1 "../active-sessions/" "PostgreSQL 活跃会话诊断（Active Sessions）"
  click n2 "./" "PostgreSQL 磁盘占用查看（Table Size / Datafile）"
  click n3 "../" "PostgreSQL"
  click n4 "../slow-queries/" "PostgreSQL 查看慢查询（Slow Query）"
  click n5 "../wal-lsn/" "PostgreSQL WAL 与 LSN"
  click n6 "../../../" "Knowledge"
  click n7 "../../../infrastructure/cloud/" "Cloud"
  click n8 "../../../infrastructure/" "Infrastructure"