必须先建唯一索引,否则 refresh materialized view concurrently 直接报错;因postgresql采用差集比对方式增量更新,需靠唯一索引列精准匹配新旧行,无索引则无法识别对应关系,故拒绝执行。

必须先建唯一索引,否则 REFRESH MATERIALIZED VIEW CONCURRENTLY 直接报错,不是慢、不是卡,是根本执行不了。
为什么 CONCURRENTLY 刷新必须有唯一索引
PostgreSQL 不是重写整张表,而是用「差集比对」方式增量更新:先生成新数据到临时关系,再靠唯一索引列做 JOIN 或 EXCEPT 找出要插入、更新、删除的行。没有唯一索引,它无法判断“哪一行对应哪一行”,就拒绝执行。
典型错误信息固定为:ERROR: cannot refresh materialized view "xxx" concurrently, because it does not have a unique index。
- 索引必须显式创建在物化视图上(
CREATE UNIQUE INDEX ON mv_name (col)),即使源表有主键,MV 上也得单独建 - 索引列必须全部
NOT NULL;允许NULL的字段会导致多行匹配失败,可用COALESCE(col, 0)包裹后建索引 - 聚合视图中若
GROUP BY a, b,索引必须覆盖全部分组列,只建(a)会逻辑不一致 - 不能用表达式索引(如
(UPPER(name))或((id::text))),必须是简单列或列组合
哪些索引算“有效”的唯一索引
只有满足以下全部条件的索引才能被 CONCURRENTLY 识别:
PostgreSQL 18.4 官方 Ubuntu 安装包现已发布,这是目前最新的稳定版本。推荐通过官方 APT 仓库安装:先执行 sudo apt update 更新索引,再运行 sudo apt install postgresql-18 即可完成部署。新版本引入了异步 I/O 子系统,在顺序扫描与 VACUUM 场景下性能提升显著,同时支持 UUID v7 原生生成函数与虚拟生成列。
- 类型是
UNIQUE或PRIMARY KEY(普通 B-tree 索引不行) - 状态为
VALID(刚建完可能需等一次VACUUM或ANALYZE后才生效) - 定义在物化视图本身,而非源表
- 不含函数调用、不带
WHERE条件(除非你确认刷新时能精确复现该条件)
常见误判:UNIQUE CONSTRAINT 不等于索引——约束可能没触发隐式索引创建(尤其在分区表或迁移后),必须手动执行 CREATE UNIQUE INDEX。
CONCURRENTLY 刷新的实际干扰点
它不锁表,但不是“零干扰”:
- 刷新期间允许
SELECT,也允许大部分 DML,但若业务写入与即将插入的新行发生唯一键冲突,会直接报错:ERROR: duplicate key value violates unique constraint - 最后阶段尝试原子替换时,若某行已被业务
UPDATE过,会失败并提示:could not lock updated tuple in materialized view - 每次刷新都需额外磁盘空间存临时副本,高频率刷新(如每分钟)可能引发空间压力
- 性能上通常比普通刷新慢,因为要全量查源表 + 差集计算 + 两次索引扫描
真正容易被忽略的是:即使索引建对了、字段非空、列全覆盖,如果物化视图刚创建还没填充过数据(即处于 WITH NO DATA 状态),CONCURRENTLY 也会拒绝执行——必须先用普通刷新填一次。










