// PostgreSQL 错误参考

PostgreSQL 54000:超出程序限制

触及了硬性实现限制,最常见的是 B 树索引条目值过大,或列或函数参数过多。

SQLSTATE
54000
名称
program_limit_exceeded
类别
超出程序限制
错误信息
index row size 3200 exceeds btree version 4 maximum 2704 for index "documents_body_idx"
DETAIL:  Index row references tuple (12,3) in relation "documents".
HINT:  Values larger than 1/3 of a buffer page cannot be indexed.
Consider a function index of an MD5 hash of the value, or use full text indexing.

它的意思

54000 (program_limit_exceeded)会在语句撞上 PostgreSQL 的某项固定限制时引发。人们最常遇到的是 B 树条目大小限制:索引值必须能放进 8 kB 页面的大约三分之一(当前 B 树索引为 2704 字节),因此当存入很大的值时,长文本列上的唯一索引会失败。

此类中的其他限制包括每个表最多 1600 列、每个函数最多 100 个参数,以及选择列表中最多 1664 个条目。

常见原因

  • 一个 B 树索引(通常来自 UNIQUE 约束),可以存储大值。
  • 生成的查询包含数千个列或表达式。
  • 调用参数超过 100 个的函数,例如非常宽的 json_build_object.

如何修复它

  1. 索引值的哈希而不是值本身;这在实际应用中仍然可以强制唯一性。

    DROP INDEX documents_body_idx;
    CREATE UNIQUE INDEX documents_body_md5_key ON documents (md5(body));
  2. 对于长文本内的搜索,请改用全文搜索或 trigram 索引,而不是 B 树。

    CREATE INDEX documents_body_fts ON documents USING gin (to_tsvector('english', body));
  3. 对于非常宽的数据,把属性存进更少的列(jsonb),并从行构建对象(to_jsonb(t)),而不是传递数百个参数。

相关错误

代码和消息文本来自 PostgreSQL 文档,附录 A:PostgreSQL 错误代码。浏览完整的 PostgreSQL 错误列表 或者 搜索每个数据库错误.

// 错误更少,修复更快

在 SQLly 中使用 PostgreSQL

适用于 macOS、Windows 和 Linux 的原生 SQL 客户端,智能感知能理解你的数据库模式,高危语句有防护,错误信息清晰,支持 PostgreSQL 以及你使用的其他数据库。