PostgreSQL默认会把所有数据文件存放在初始化数据库时指定的数据目录中。当单块磁盘的容量不足以支撑业务增长，或者你希望把频繁访问的热表放到SSD上、把归档冷数据放到机械硬盘上时，表空间就派上了用场。表空间本质上是一个逻辑存储单元，它把数据库对象的物理存储位置指向操作系统中的某个目录。PostgreSQL在数据目录的pg_tblspc子目录下为每个表空间维护一个符号链接，这个链接以表空间的OID命名，指向真正的文件系统目录。理解这层映射关系，是后续进行表空间管理、监控和物理移动的前提。
一、表空间的核心概念与系统目录
PostgreSQL在初始化时会自动创建两个默认表空间：pg_default和pg_global。pg_default用于存放普通的用户数据和系统目录，pg_global则存放集群级别的共享系统表。当用户创建新的表空间后，PostgreSQL会向pg_tablespace系统表中插入一条记录，记录表空间名称、所有者以及对应的OID。可以通过pg_tablespace_location函数查看某个表空间的实际物理路径，例如执行SELECT spcname, pg_tablespace_location(oid) FROM pg_tablespace;就可以列出所有表空间及其目录位置。
需要注意的是，表空间并不是简单的目录别名。PostgreSQL在写入数据时，会根据对象所属表空间的OID，到pg_tblspc目录下查找对应的符号链接，再通过该链接定位到实际存储位置。如果符号链接缺失或指向错误路径，数据库将无法启动，或者启动后一旦访问相关表就会报错。因此在对表空间做物理迁移时，必须保证链接名称与pg_tablespace中的OID完全一致，并且新的目标目录拥有正确的属主和权限。
另外，PostgreSQL不允许把表空间创建在数据目录内部，因为这样会导致备份工具和文件系统管理出现混乱。表空间目录应当位于数据目录之外，通常建议使用独立的挂载点或独立磁盘，以获得更好的容量隔离和I/O性能。
二、创建表空间与分配数据库对象
创建表空间的语法比较简单，但前提是目标目录必须已经存在，并且属于运行PostgreSQL服务的操作系统用户，同时目录权限应当设置为700，避免其他系统用户访问。下面是一个典型的创建示例：
CREATE TABLESPACE fastspace LOCATION '/mnt/ssd/pgdata';
执行这条语句前，需要先以postgres系统用户在文件系统中创建/mnt/ssd/pgdata目录。如果目录不存在，PostgreSQL会直接报错；如果目录权限过于宽松，PostgreSQL也会给出警告，因为表空间目录通常包含敏感的数据库文件，权限控制非常重要。创建完成后，可以在创建数据库、表或索引时指定该表空间。
例如，把整个数据库的默认表空间设置为fastspace：
CREATE DATABASE mydb TABLESPACE fastspace;
也可以为单个表或索引指定表空间：
CREATE TABLE orders (
id bigint PRIMARY KEY,
created_at timestamp with time zone
) TABLESPACE fastspace;
CREATE INDEX idx_orders_created_at
ON orders (created_at)
TABLESPACE fastspace;
如果表已经存在，希望把整个表迁移到另一个表空间，可以使用ALTER TABLE命令。这个操作会在新表空间中重新创建数据文件，并复制原表数据，完成后删除旧文件。执行期间会对表加ACCESS EXCLUSIVE锁，阻塞读写，所以对大表操作时需要安排在维护窗口。示例如下：
ALTER TABLE orders SET TABLESPACE fastspace;
索引也可以单独迁移：
ALTER INDEX idx_orders_created_at SET TABLESPACE fastspace;
如果需要批量移动某个模式下的所有表，可以通过查询系统目录动态生成SQL脚本。例如先找到目标模式下的所有普通表，再用循环执行ALTER TABLE。不过生产环境中更推荐逐表评估锁影响和数据量，避免一次性锁住过多对象。移动表或索引时，如果目标表空间所在磁盘空间不足，操作会失败并回滚，但过程中可能产生大量WAL日志，需要提前预留磁盘空间。
三、将整个表空间物理迁移到新磁盘
ALTER TABLE只能完成逻辑对象级别的迁移，但有时我们需要把整个表空间从一块磁盘搬到另一块磁盘，例如旧SSD退役、挂载点调整或扩容新盘。PostgreSQL没有提供直接修改表空间路径的SQL命令，因此物理迁移通常需要短暂停机操作。
第一步，查询表空间对应的OID和当前路径。假设表空间fastspace的OID为16384：
SELECT oid, spcname, pg_tablespace_location(oid) FROM pg_tablespace WHERE spcname = 'fastspace';
记录下OID和原路径，然后停止数据库服务。以Linux环境为例：
pg_ctl stop -D /var/lib/pgsql/data
第二步，将原表空间目录完整复制到新位置，并保持属主和权限不变。可以使用cp的归档模式，也可以用rsync：
cp -a /mnt/ssd/pgdata /mnt/nvme/pgdata
第三步，进入集群数据目录下的pg_tblspc子目录，删除旧的符号链接，并创建指向新位置的符号链接。符号链接的名称必须是对应的表空间OID，这里是16384：
cd /var/lib/pgsql/data/pg_tblspc rm 16384 ln -s /mnt/nvme/pgdata 16384
第四步，重新启动PostgreSQL服务：
pg_ctl start -D /var/lib/pgsql/data
启动后立即验证路径是否正确：
SELECT oid, spcname, pg_tablespace_location(oid) FROM pg_tablespace WHERE oid = 16384;
如果返回的路径是/mnt/nvme/pgdata，说明符号链接已经生效。还可以对表空间中的表执行一次简单的SELECT或INSERT测试，确认读写正常。迁移过程中最大的风险是符号链接指向错误或权限不正确，因此务必在启动前使用ls -l检查链接，并确保新目录的属主为postgres。
如果生产环境不允许长时间停机，可以考虑先通过ALTER TABLE把表空间中的对象迁移到临时表空间，然后删除旧表空间，再在新位置创建同名表空间，最后把对象迁回。这种方法可以在线操作，但会产生大量数据复制和锁等待，适合中小规模数据。对于大型数据库，停机复制仍然是更可控的方案。
四、监控表空间使用情况与常见问题
表空间一旦投入使用，就需要持续监控磁盘占用，防止存储空间耗尽导致数据库写入失败。PostgreSQL提供了pg_tablespace_size函数，可以查询单个表空间占用的字节数。结合pg_size_pretty可以直观显示容量：
SELECT ts.spcname,
pg_size_pretty(pg_tablespace_size(ts.oid)) AS size
FROM pg_tablespace ts
ORDER BY pg_tablespace_size(ts.oid) DESC;
如果想找出当前数据库中最占空间的表和索引，可以使用pg_total_relation_size函数：
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 10;
当表空间所在磁盘剩余空间不足时，INSERT、UPDATE等写入操作会报错，错误信息通常包含no space left on device。这时应尽快清理无用数据、执行VACUUM FULL或迁移对象到更大的表空间。日常巡检中可以把表空间容量查询纳入监控脚本，并设置阈值告警，避免被动响应。
常见问题还包括删除表空间失败。DROP TABLESPACE只能删除没有任何对象的表空间，如果表空间中还有表、索引或数据库对象，系统会报错。需要先移动或删除这些对象，再执行：
DROP TABLESPACE fastspace;
此外，备份和恢复时也要特别注意表空间路径。使用pg_basebackup进行物理备份时，表空间文件会一并备份，但恢复时如果目标机器路径不一致，可以通过-T选项进行路径映射。例如原路径是/mnt/ssd/pgdata，新机器希望恢复到/mnt/nvme/pgdata，可以在恢复时使用映射参数，避免启动后符号链接指向错误。这些操作都需要在规划存储架构时一并考虑，才能让表空间真正发挥灵活管理物理存储的作用。
PostgreSQL表空间tablespace管理表空间移动修改时间：2026-08-24 14:10:02