PostgreSQL中如何判断排除约束是否存在并避免添加报错

问题场景 #

执行添加排它约束的语句时：

alter table dok add constraint dok_during_exclude EXCLUDE USING gist (pais2obj WITH =, during WITH &&)

触发错误：

ERROR: relation "dok_during_exclude" already exists

但执行以下查询均无结果返回：

select * from information_schema.table_constraints where constraint_name ilike 'dok_during_exclude'

select * from information_schema.tables where table_name ilike 'dok_during_exclude'

尝试使用IF NOT EXISTS语法规避时：

alter table dok add constraint if not exists dok_during_exclude EXCLUDE USING gist (pais2obj WITH =, during WITH &&)

在PostgreSQL 12和17版本中均抛出语法错误：

syntax error at or near "not"

核心原因 #

PostgreSQL的排它约束（EXCLUDE constraint）会自动创建同名的GIST索引，报错中的"relation"实际指的是这个索引对象，而非约束本身或数据表。information_schema.table_constraints无法直接关联到索引，所以查询不到结果。

检查约束/索引存在性的正确方法 #

1. 直接查询系统表pg_constraint定位排它约束 #

select conname, conrelid::regclass
from pg_constraint
where conname = 'dok_during_exclude'
  and contype = 'x'; -- 'x'是排它约束的类型标识

2. 查询系统表pg_index和pg_class检查对应索引 #

select c.relname as index_name, t.relname as table_name
from pg_index i
join pg_class c on i.indexrelid = c.oid
join pg_class t on i.indrelid = t.oid
where c.relname = 'dok_during_exclude';

3. 使用psql元命令快速查看 #

在psql客户端中执行：

\d dok

输出会列出表dok的所有约束、索引信息，可直接找到目标排它约束及对应索引。

关于IF NOT EXISTS的问题 #

PostgreSQL 15版本才开始支持在添加排它约束时使用IF NOT EXISTS语法：

• PostgreSQL 12及更早版本完全不支持该语法，因此会触发语法错误。
• PostgreSQL 17虽支持，但如果仍报错，需检查是否存在同名索引（此时需先删除索引或修改约束名称）。

解决方案 #

针对PostgreSQL 12及更早版本 #

通过PL/pgSQL脚本先检查约束是否存在，再执行添加操作：

do $$
begin
  if not exists (
    select 1 from pg_constraint
    where conname = 'dok_during_exclude'
      and conrelid = 'dok'::regclass
      and contype = 'x'
  ) then
    alter table dok add constraint dok_during_exclude EXCLUDE USING gist (pais2obj WITH =, during WITH &&);
  end if;
end $$;

针对PostgreSQL 15及以上版本 #

直接使用支持的IF NOT EXISTS语法：

alter table dok add constraint if not exists dok_during_exclude EXCLUDE USING gist (pais2obj WITH =, during WITH &&);

内容的提问来源于stack exchange，提问作者Andrus