// PostgreSQL 错误参考
PostgreSQL 54000:超出程序限制
触及了硬性实现限制,最常见的是 B 树索引条目值过大,或列或函数参数过多。
- SQLSTATE
54000- 名称
program_limit_exceeded- 类别
- 超出程序限制
它的意思
54000 (program_limit_exceeded)会在语句撞上 PostgreSQL 的某项固定限制时引发。人们最常遇到的是 B 树条目大小限制:索引值必须能放进 8 kB 页面的大约三分之一(当前 B 树索引为 2704 字节),因此当存入很大的值时,长文本列上的唯一索引会失败。
此类中的其他限制包括每个表最多 1600 列、每个函数最多 100 个参数,以及选择列表中最多 1664 个条目。
常见原因
- 一个 B 树索引(通常来自
UNIQUE约束),可以存储大值。 - 生成的查询包含数千个列或表达式。
- 调用参数超过 100 个的函数,例如非常宽的
json_build_object.
如何修复它
-
索引值的哈希而不是值本身;这在实际应用中仍然可以强制唯一性。
DROP INDEX documents_body_idx; CREATE UNIQUE INDEX documents_body_md5_key ON documents (md5(body));
-
对于长文本内的搜索,请改用全文搜索或 trigram 索引,而不是 B 树。
CREATE INDEX documents_body_fts ON documents USING gin (to_tsvector('english', body)); -
对于非常宽的数据,把属性存进更少的列(
jsonb),并从行构建对象(to_jsonb(t)),而不是传递数百个参数。
相关错误
代码和消息文本来自 PostgreSQL 文档,附录 A:PostgreSQL 错误代码。浏览完整的 PostgreSQL 错误列表 或者 搜索每个数据库错误.
// 错误更少,修复更快
在 SQLly 中使用 PostgreSQL
适用于 macOS、Windows 和 Linux 的原生 SQL 客户端,智能感知能理解你的数据库模式,高危语句有防护,错误信息清晰,支持 PostgreSQL 以及你使用的其他数据库。