0Pricing
SQL Academy · 课时

并发创建索引（CREATE INDEX CONCURRENTLY）

使用 CREATE INDEX CONCURRENTLY 创建索引而不阻塞写入，并从中断的创建过程恢复

并发创建索引（CREATE INDEX CONCURRENTLY） 是 CoddyKit 上的免费 SQL Academy 课时。 这是第 2 节课，共 4 节。 你可以在下方免费阅读本课时的完整内容 — 然后在浏览器中使用内置代码编辑器和全天候 AI 导师进行实践。 这是 SQL Academy 学习路径的一部分，你的进度在网页和 CoddyKit 应用中同步。 SQL Academy 课程共包含 4 节课。

CREATE INDEX 的问题

普通的 CREATE INDEX 会获取 SHARE 锁 — 在整个构建期间阻止写入（但不阻止读取）。对于拥有十亿行的表，这意味着数分钟的写入中断。

CONCURRENTLY：解决方案

CREATE INDEX CONCURRENTLY 会在不阻塞写入的情况下构建索引：

CREATE INDEX CONCURRENTLY idx_orders_user_id ON orders(user_id);

工作原理

扫描表两次：

  1. 第一次扫描：根据当前行构建索引
  2. 第二次扫描：捕获第一次扫描期间发生变化的行

此外，还需要短暂等待所有在构建开始前启动的并发事务。

不能在事务中运行

CONCURRENTLY 会提交两次 — 因此不能放在显式的 BEGIN/COMMIT 块中：

BEGIN;
CREATE INDEX CONCURRENTLY ...;  -- ERROR
COMMIT;

速度较慢，但可在线运行

CONCURRENTLY 比普通的 CREATE INDEX 耗时更长（需要两次扫描和锁等待）。其优势是：零停机。

故障恢复

如果 CONCURRENTLY 失败（被中断或发生系统错误），索引会处于 INVALID 状态：

SELECT relname FROM pg_class
WHERE relkind = 'i' AND NOT pg_index.indisvalid;

-- Fix: drop and re-create:
DROP INDEX CONCURRENTLY my_idx;
CREATE INDEX CONCURRENTLY my_idx ON ...;

REINDEX CONCURRENTLY

从 PG 12 开始，可以在不阻塞的情况下重建：

REINDEX INDEX CONCURRENTLY orders_user_id_idx;
REINDEX TABLE CONCURRENTLY orders;

DROP INDEX CONCURRENTLY

同样不会阻塞：

DROP INDEX CONCURRENTLY old_idx;

唯一索引

UNIQUE 索引也可以使用 CONCURRENTLY 构建。这对于在线添加 UNIQUE 约束很有用：

CREATE UNIQUE INDEX CONCURRENTLY users_email_uidx ON users(email);
ALTER TABLE users ADD CONSTRAINT users_email_unique UNIQUE USING INDEX users_email_uidx;

外键索引

向大表添加 FK 时的标准模式：

-- 1. Build the index online:
CREATE INDEX CONCURRENTLY orders_user_id_idx ON orders(user_id);

-- 2. Add the FK with NOT VALID (instant):
ALTER TABLE orders ADD CONSTRAINT orders_user_fk
  FOREIGN KEY (user_id) REFERENCES users(id) NOT VALID;

-- 3. Validate in the background:
ALTER TABLE orders VALIDATE CONSTRAINT orders_user_fk;

并发构建索引的成本

两次完整的表扫描，加上记录维护开销。会消耗 CPU 和 IO。可能的话，请在低流量时段运行。

监控进度

PG 12+ 会在 pg_stat_progress_create_index 中提供进度信息：

SELECT phase,
       blocks_done, blocks_total,
       tuples_done, tuples_total
FROM pg_stat_progress_create_index;

回顾

CONCURRENTLY 是在生产环境中管理索引的友好方式。

  • CREATE/DROP/REINDEX CONCURRENTLY 不会阻塞写入
  • 不能放在事务中
  • 失败会留下 INVALID 索引 — 请进行清理
  • 使用 pg_stat_progress_create_index 进行监控

快速检查

为什么 CREATE INDEX CONCURRENTLY 不能在显式的 BEGIN/COMMIT 块中运行？

常见问题解答

「并发创建索引（CREATE INDEX CONCURRENTLY）」课时是免费的吗？

是的 — 「并发创建索引（CREATE INDEX CONCURRENTLY）」的完整文本可在网页上免费阅读。要进行交互式练习（内置代码编辑器和全天候 AI 导师）并解锁 SQL Academy 课程的其余内容，请升级到 CoddyKit PRO。 SQL Academy 课程共包含 4 节课。

「并发创建索引（CREATE INDEX CONCURRENTLY）」这节课中我会学到什么？

使用 CREATE INDEX CONCURRENTLY 创建索引而不阻塞写入，并从中断的创建过程恢复 你通过在浏览器中直接运行的动手代码来练习 SQL Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。

学习 SQL Academy 需要有经验吗？

无需任何先前经验。CoddyKit 上的 SQL Academy 课程适合初学者到高级学习者，你可以从这里开始或从头开始，按照自己的节奏学习。 这是第 2 节课，共 4 节。

「并发创建索引（CREATE INDEX CONCURRENTLY）」课时需要多长时间？

大多数 CoddyKit 课程大约需要 5–10 分钟。每节课都很精短且互动，所以你能稳步进步，并在网页和应用中从离开的地方继续。

我能在这节 SQL Academy 课中编写并运行代码吗？

能。每节 SQL Academy 课都包含内置代码编辑器，你可以在浏览器中直接编写并运行真实代码，并获得即时 AI 反馈 — 无需本地设置。

此课程中的所有课时

  1. 在线迁移：ALTER TABLE 为何会加锁
  2. 并发创建索引（CREATE INDEX CONCURRENTLY）
  3. 零停机重命名列
  4. 工具：Flyway、Liquibase、Sqitch
← 返回 SQL Academy