PostgreSQL / 系统课时
执行并发索引重建
执行并发索引重建
本课解决线上索引需要重建、又不能长时间阻塞业务写入的问题。你将掌握 REINDEX CONCURRENTLY 的执行路径、额外资源成本与失败后的检查方法,并能在生产环境前后建立明确的操作门禁。
学习目标
- 能选择合适的索引并安全执行
REINDEX CONCURRENTLY - 能判断并发重建带来的锁、CPU、磁盘与执行时长成本
- 能在重建异常后识别失效索引并完成恢复验证
先确认并发重建的边界
普通 REINDEX 会在重建期间阻止目标表的写操作,而 REINDEX CONCURRENTLY 允许并发的 INSERT、UPDATE、DELETE 继续进行,因此更适合在线业务。它并不意味着“完全没有锁”:重建过程中仍需要等待可能使用该索引的事务结束,也不能与其他表结构修改无限制地并行进行。:contentReference[oaicite:0]{index=0}
并发方式还会产生更高的资源与时间成本。一个索引的并发重建需要多次扫描表,并且同一张表同一时间只能进行一个并发索引构建;长时间运行的重建还可能增加事务与 VACUUM 的压力。:contentReference[oaicite:1]{index=1}

执行前先做资源检查
不要把“没有明显阻塞”理解成“可以直接重建”。大索引重建前至少确认剩余磁盘空间、当前长事务、是否存在正在执行的 DDL,以及业务高峰是否临近。尤其要关注目标索引所在表是否刚经历大批量写入,因为重建本身会继续消耗 I/O 和 CPU。
可以先查看候选索引的体积和最近访问情况。下面示例只读系统视图,不会修改数据。
SELECT
s.schemaname,
s.relname AS table_name,
s.indexrelname AS index_name,
pg_size_pretty(pg_relation_size(s.indexrelid)) AS index_size,
s.idx_scan
FROM pg_stat_user_indexes AS s
WHERE s.indexrelname = 'idx_orders_customer_id';预期结果
schemaname | table_name | index_name | index_size | idx_scan
------------+------------+--------------------------+------------+----------
public | orders | idx_orders_customer_id | 12 GB | 1845321实际大小和扫描次数取决于当前数据库,重点是确认目标对象、索引规模与业务使用情况。
执行并观察重建
确认窗口后,使用 REINDEX INDEX CONCURRENTLY 重建单个索引。该命令不能放在显式事务块中;单个表上的并发索引构建也不能无限并行。:contentReference[oaicite:2]{index=2}
REINDEX (VERBOSE) INDEX CONCURRENTLY public.idx_orders_customer_id;预期结果
INFO: index "public.idx_orders_customer_id" was rebuilt
REINDEX对于超大索引,不应只盯着客户端是否仍然有输出。可以结合 pg_stat_progress_create_index 观察当前索引构建阶段,判断它是在扫描、等待还是接近完成。:contentReference[oaicite:3]{index=3}
SELECT
pid,
relid::regclass AS table_name,
index_relid::regclass AS index_name,
phase,
lockers_total,
lockers_done,
blocks_total,
blocks_done
FROM pg_stat_progress_create_index;预期结果
pid | table_name | index_name | phase | lockers_total | lockers_done | blocks_total | blocks_done
------+------------+-------------------------+----------------------------------+---------------+--------------+--------------+------------
8421 | public.orders | public.idx_orders_customer_id | building index: scanning table | 2 | 1 | 1562500 | 932400实际阶段名称会随执行阶段变化,blocks_done 也会持续增长;不要把示例中的 PID 或数字当成固定值。
失败后不要直接重复执行
并发索引构建如果失败,可能留下一个处于 INVALID 状态的索引对象。此类索引不能正常承担查询优化职责,处理时应先确认状态,再决定直接重新执行并发重建或清理异常对象。:contentReference[oaicite:4]{index=4}
SELECT
c.oid::regclass AS index_name,
i.indisvalid,
i.indisready
FROM pg_class AS c
JOIN pg_index AS i ON i.indexrelid = c.oid
WHERE c.oid = 'public.idx_orders_customer_id'::regclass;预期结果
index_name | indisvalid | indisready
--------------------------+------------+------------
public.idx_orders_customer_id | t | t若失败后发现 indisvalid = f,先查数据库日志、锁等待和资源状态,确认失败原因已经消除,再执行针对该索引的修复操作。不要在磁盘已经逼近上限时反复重试,否则新的临时对象和写放大会进一步加剧资源压力。
生产环境的操作门禁
并发重建适合降低写阻塞,不等于可以跳过变更控制。实际执行前应至少同时满足“对象明确、磁盘有余量、无异常长事务、无冲突 DDL、业务处于允许窗口”这几个条件;执行中持续观察进度、I/O 和事务等待;完成后再次检查索引状态和业务查询指标。
真正安全的重建不是把一条 REINDEX CONCURRENTLY 命令跑通,而是让重建过程、异常分支和恢复动作都具备可观测、可停止、可验证的边界。