Hasura不显示/找不到Postgres中已存在的唯一索引问题求助

核心原因 #

你遇到的冲突问题本质是两个点：

• PostgreSQL中**唯一索引（UNIQUE INDEX）和唯一约束（UNIQUE CONSTRAINT）**不是等价概念。Hasura的唯一键识别、upsert操作的constraint参数，都依赖PostgreSQL表级别的显式唯一约束，而通过Rails add_index(..., unique: true) 默认创建的是独立的唯一索引，不会被自动识别为表约束。
• Hasura不会主动实时同步数据库Schema变更，你在数据库层做的修改需要手动触发重载才会更新到Hasura元数据中。

你之前操作的报错逻辑也对应这个原因：

1. 手动点击Add按钮添加唯一键时，Hasura会尝试新建同名唯一约束，会自动生成新的同名索引，和你已有的索引冲突，所以报relation "customers_merchant_id_email_key" already exists错误
2. 因为Hasura元数据中没有记录这个约束，所以upsert操作时会提示约束不存在。

解决步骤 #

步骤1：将现有唯一索引关联为表约束 #

执行如下SQL，直接复用现有唯一索引创建表约束，不会重复生成索引：

ALTER TABLE public.customers 
ADD CONSTRAINT customers_merchant_id_email_key 
UNIQUE USING INDEX customers_merchant_id_email_key;

你可以先执行下面的SQL验证是否已经存在对应约束，如果有返回结果则跳过这一步：

SELECT conname FROM pg_constraint WHERE conname = 'customers_merchant_id_email_key';

步骤2：重载Hasura数据库Schema #

• 打开Hasura控制台，进入Data页签
• 找到customers表所属的数据源，点击数据源右侧的设置按钮
• 点击Reload Database选项，等待元数据重载完成

操作完成后再查看customers表的唯一键配置，就能看到对应约束，upsert操作也可以正常使用该约束。

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