PHP调用pg_execute更新时提示索引行大小超限错误如何解决

错误含义解释 #

你遇到的报错是PostgreSQL B-tree索引的固有大小限制导致的：

Warning pg_execute(): Query failed: ERROR: index row size 2728 exceeds maximum 2717 for index "index_name"
默认配置下PostgreSQL的页大小为8KB，单条B-tree索引条目的最大存储上限为2717字节。你的field_name字段上创建了名为index_name的B-tree索引，执行array_cat拼接数组后，该字段的新值生成的索引条目大小达到了2728字节，超出限制所以执行报错。

数据是否会写入数据库的问题解答 #

该UPDATE操作完全失败，你的变更不会被写入数据库。PostgreSQL默认单条SQL执行时会开启隐式事务，执行过程中出现任何错误都会回滚整条语句的所有变更，不会出现“数据写入成功但索引创建失败”的半完成状态。

可行的解决方案 #

• 如果你需要查询数组内的元素，将field_name字段上的B-tree索引替换为GIN索引，GIN索引专为数组、JSON这类复合类型设计，不存在单条目大小限制，同时对数组包含、相交类的查询性能更好。
• 如果你不需要针对该字段做前缀匹配、排序等B-tree索引支持的查询，可以直接删除该字段上的B-tree索引，避免该类报错。
• 业务层面限制field_name字段存储的数组总长度，控制单条值的大小不超过2700字节即可兼容现有B-tree索引。

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