PostgreSQL / 系统课时

执行并发索引重建

执行并发索引重建

本课解决线上索引需要重建、又不能长时间阻塞业务写入的问题。你将掌握 REINDEX CONCURRENTLY 的执行路径、额外资源成本与失败后的检查方法,并能在生产环境前后建立明确的操作门禁。

学习目标

  • 能选择合适的索引并安全执行 REINDEX CONCURRENTLY
  • 能判断并发重建带来的锁、CPU、磁盘与执行时长成本
  • 能在重建异常后识别失效索引并完成恢复验证

先确认并发重建的边界

普通 REINDEX 会在重建期间阻止目标表的写操作,而 REINDEX CONCURRENTLY 允许并发的 INSERT、UPDATE、DELETE 继续进行,因此更适合在线业务。它并不意味着“完全没有锁”:重建过程中仍需要等待可能使用该索引的事务结束,也不能与其他表结构修改无限制地并行进行。:contentReference[oaicite:0]{index=0}

并发方式还会产生更高的资源与时间成本。一个索引的并发重建需要多次扫描表,并且同一张表同一时间只能进行一个并发索引构建;长时间运行的重建还可能增加事务与 VACUUM 的压力。:contentReference[oaicite:1]{index=1}

REINDEX CONCURRENTLY 的在线重建与切换路径

执行前先做资源检查

不要把“没有明显阻塞”理解成“可以直接重建”。大索引重建前至少确认剩余磁盘空间、当前长事务、是否存在正在执行的 DDL,以及业务高峰是否临近。尤其要关注目标索引所在表是否刚经历大批量写入,因为重建本身会继续消耗 I/O 和 CPU。

可以先查看候选索引的体积和最近访问情况。下面示例只读系统视图,不会修改数据。

sql
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';

预期结果

text
 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}

sql
REINDEX (VERBOSE) INDEX CONCURRENTLY public.idx_orders_customer_id;

预期结果

text
INFO:  index "public.idx_orders_customer_id" was rebuilt
REINDEX

对于超大索引,不应只盯着客户端是否仍然有输出。可以结合 pg_stat_progress_create_index 观察当前索引构建阶段,判断它是在扫描、等待还是接近完成。:contentReference[oaicite:3]{index=3}

sql
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;

预期结果

text
 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}

sql
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;

预期结果

text
        index_name         | indisvalid | indisready
--------------------------+------------+------------
 public.idx_orders_customer_id | t          | t

若失败后发现 indisvalid = f,先查数据库日志、锁等待和资源状态,确认失败原因已经消除,再执行针对该索引的修复操作。不要在磁盘已经逼近上限时反复重试,否则新的临时对象和写放大会进一步加剧资源压力。

生产环境的操作门禁

并发重建适合降低写阻塞,不等于可以跳过变更控制。实际执行前应至少同时满足“对象明确、磁盘有余量、无异常长事务、无冲突 DDL、业务处于允许窗口”这几个条件;执行中持续观察进度、I/O 和事务等待;完成后再次检查索引状态和业务查询指标。

真正安全的重建不是把一条 REINDEX CONCURRENTLY 命令跑通,而是让重建过程、异常分支和恢复动作都具备可观测、可停止、可验证的边界。

按自己的节奏,确认真正理解。

目录与阅读设置

记录一个想法

执行并发索引重建

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通