PostgreSQL创建含INCLUDE列索引报错：索引行超8191字节限制（错误54000）

问题原因 #

你使用的默认B-tree索引，不管是索引键列还是INCLUDE列，所有字段的总大小不能超过8191字节（PostgreSQL默认块大小限制）。你的memo是存储大量数据的bytea类型，直接放入INCLUDE必然触发尺寸超限报错。btree_gist和postgis扩展针对空间数据或特定索引类型，和当前问题无关，因此无法解决。

可行解决方案 #

• 移除INCLUDE中的大字段：若业务允许，仅将小字段（如type）保留在INCLUDE中，大字段memo由数据库查询时回表读取原数据。修改后的索引语句：

  CREATE INDEX IDX_memo ON dbo.tbl_memo
  (crtdate ASC, Inov ASC)
  INCLUDE(type);
  

• 使用部分索引缩小范围：如果你的查询仅针对特定范围的数据（比如近期记录），可以给索引添加WHERE条件，仅对符合条件的行创建索引，同时保留INCLUDE列。示例：

  CREATE INDEX IDX_memo_partial ON dbo.tbl_memo
  (crtdate ASC, Inov ASC)
  INCLUDE(memo, type)
  WHERE crtdate >= '2023-01-01'; -- 根据实际业务调整过滤条件
  

• 用哈希值替代原大字段：若必须通过索引关联memo，可以给表添加存储memo哈希值的计算字段，将哈希值放入INCLUDE中，查询时先通过哈希值过滤，再回表验证原memo：

  1. 添加计算字段：

     ALTER TABLE dbo.tbl_memo ADD COLUMN memo_hash text GENERATED ALWAYS AS (md5(memo::text)) STORED;
     

  2. 创建索引：

     CREATE INDEX IDX_memo_hash ON dbo.tbl_memo
     (crtdate ASC, Inov ASC)
     INCLUDE(memo_hash, type);
     

  查询时先用memo_hash匹配，再对比原memo确保准确性。

• 不推荐方案：调整数据库块大小：修改block_size参数可增大索引行最大尺寸，但需要重新初始化数据库，风险极高，仅在其他方案均不可行时考虑。

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