必须先建满足条件的唯一索引,否则REFRESH MATERIALIZED VIEW CONCURRENTLY直接报错拒绝执行;因PostgreSQL依赖该索引进行新旧行差集比对以实现并发刷新,缺索引则无法匹配行,故语法级拦截。

必须先建唯一索引,否则 REFRESH MATERIALIZED VIEW CONCURRENTLY 直接失败,不是慢、不是卡,是语法级拒绝执行。
为什么 CONCURRENTLY 刷新总报错 “does not have a unique index”
PostgreSQL 用差集比对方式实现并发刷新:生成新数据临时关系 → 按唯一索引列 JOIN/EXCEPT 对比新旧行 → 算出 INSERT/UPDATE/DELETE 集合。没有唯一索引,它根本不知道“哪一行该更新哪一行”。
- 错误信息固定为:
ERROR: cannot refresh materialized view "xxx" concurrently, because it does not have a unique index - 索引必须显式建在物化视图上,源表的主键或唯一约束不继承过去
- 索引列全部要
NOT NULL;含 NULL 的字段会导致多行匹配歧义,可用COALESCE(col, 0)包裹后建索引 - 若物化视图是聚合查询(如
GROUP BY a, b),唯一索引必须覆盖全部分组列,顺序也要一致((a, b)≠(b, a)) - 禁止用表达式索引,例如
(UPPER(name))或((id::text))—— 只接受简单列名或列组合
CREATE UNIQUE INDEX 怎么写才被 CONCURRENTLY 认可
只有满足全部下述条件的索引,才会被 PostgreSQL 15 的并发刷新逻辑识别:
- 类型是
UNIQUE或PRIMARY KEY(普通B-tree索引不行) - 状态为
VALID(刚建完可能需等一次ANALYZE或VACUUM才生效) - 定义在物化视图本身,而非其底层表
- 不含函数调用、不带
WHERE条件(除非你确认刷新时能精确复现该过滤逻辑)
常见误判:UNIQUE CONSTRAINT 不等于索引——某些迁移或分区场景下,约束未触发隐式索引创建,必须手动执行 CREATE UNIQUE INDEX。
REFRESH MATERIALIZED VIEW CONCURRENTLY 的实际干扰点
它不锁表,但不是“零代价”:
- 刷新期间允许
SELECT,也允许大部分 DML,但若业务写入与即将插入的新行发生唯一键冲突,会直接报错:ERROR: duplicate key value violates unique constraint - 最后阶段尝试原子替换时,若某行已被业务
UPDATE过,会失败并提示:could not lock updated tuple in materialized view - 每次刷新都需额外磁盘空间存临时副本;高频率刷新(如每分钟)易引发空间压力
- 性能通常比普通刷新慢:要全量查源表 + 差集计算 + 两次索引扫描;当数据差异大或物化视图超大时,
pg_stat_activity中可见大量Hash Join和Sort - 即使索引建对了、字段非空、列全覆盖,如果物化视图刚用
WITH NO DATA创建且尚未填充过数据,CONCURRENTLY也会拒绝执行 —— 必须先用普通刷新填一次
聚合物化视图的典型建法与陷阱
比如按部门+年份聚合销售数据:
CREATE MATERIALIZED VIEW sales_summary AS SELECT department, EXTRACT(YEAR FROM order_date) AS year, SUM(amount) FROM orders GROUP BY department, EXTRACT(YEAR FROM order_date) WITH DATA;
这个写法看似合理,但有隐患:
-
EXTRACT(YEAR FROM order_date)返回double precision,而你在查询时写WHERE year = 2023(整型),触发隐式转换 → 索引失效 - 更稳妥的是统一类型:
EXTRACT(YEAR FROM order_date)::int,并在索引中保持一致 - 建索引必须覆盖全部分组列:
CREATE UNIQUE INDEX idx_sales_summary_dept_year ON sales_summary (department, year) - 别忘了检查字段是否
NOT NULL;如有空值风险,改写为:GROUP BY department, COALESCE(EXTRACT(YEAR FROM order_date)::int, 0)
真正容易被忽略的是:索引建好之后,得立刻 ANALYZE sales_summary 更新统计信息,否则优化器可能因统计不准而回退到全量扫描比对,导致刷新变慢数倍。










