如何用单条查询语句获取数据库所有表的FreeSpace总和

架构老林

2026-5-15

解决方案：单条SQL计算所有用户表的VACUUM标记空闲空间总和

要实现这个需求，我们可以通过嵌套查询+动态调用pg_freespace函数的方式，遍历所有用户表并聚合它们的空闲空间总和。以下是具体的SQL语句：

基础版本（适用于单schema场景）

SELECT SUM(free_space) AS total_free_space
FROM (
    -- 对每个用户表调用pg_freespace计算单表空闲空间
    SELECT (SELECT SUM(avail) FROM pg_freespace(relname::regclass)) AS free_space
    FROM pg_stat_user_tables
) AS table_free_spaces;

增强版本（处理跨schema+NULL值）

如果你的用户表分布在不同schema下，或者存在某些表没有空闲空间（此时pg_freespace会返回NULL），可以用下面更严谨的写法：

SELECT SUM(COALESCE(free_space, 0)) AS total_free_space
FROM (
    SELECT (
        SELECT SUM(avail) 
        FROM pg_freespace((relnamespace::regnamespace || '.' || relname)::regclass)
    ) AS free_space
    FROM pg_stat_user_tables
) AS table_free_spaces;

关键细节解释

relname::regclass：把表名字符串转换成PostgreSQL的regclass类型，确保数据库能正确识别表（自动处理表名大小写、特殊字符等问题）。
跨schema处理：relnamespace::regnamespace会把schema的OID转换成schema名称，拼接成schema.table格式的完整表名，避免同名表的冲突。
COALESCE(free_space, 0)：如果某个表没有被VACUUM标记的空闲空间，pg_freespace会返回NULL，用COALESCE把NULL替换为0，保证总和计算准确。