// справочник ошибок 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 кБ (2704 байта для нынешних B-деревьев), поэтому уникальный индекс по длинному текстовому столбцу выдаёт ошибку, когда приходит большое значение.

Другие ограничения в этом классе включают максимум 1600 столбцов на таблицу, 100 аргументов на функцию и 1664 элемента в списке SELECT.

Распространённые причины

  • Индекс B-дерева (часто из UNIQUE ограничения) на столбец типа text, JSON или bytea, который может содержать большие значения.
  • Сгенерированный запрос с тысячами столбцов или выражений.
  • Вызов функции с более чем 100 аргументами, например очень широкий json_build_object.

Как исправить

  1. Индексируйте хеш значения вместо самого значения; на практике уникальность это всё равно обеспечивает.

    DROP INDEX documents_body_idx;
    CREATE UNIQUE INDEX documents_body_md5_key ON documents (md5(body));
  2. Для поиска внутри длинного текста используйте полнотекстовый поиск или триграммные индексы вместо B-дерева.

    CREATE INDEX documents_body_fts ON documents USING gin (to_tsvector('english', body));
  3. Для очень широких данных храните атрибуты в меньшем количестве столбцов (jsonb), и создавать объекты из строк (to_jsonb(t)), а не передавать сотни аргументов.

Связанные ошибки

Код и текст сообщения взяты из Документация PostgreSQL, приложение A: коды ошибок PostgreSQL. Смотрите весь Список ошибок PostgreSQL или поиск по всем ошибкам баз данных.

// меньше ошибок, быстрее исправления

Работа с PostgreSQL в SQLly

Нативный SQL-клиент для macOS, Windows и Linux с IntelliSense, который знает вашу схему, предохранителями для рискованных запросов и понятными сообщениями об ошибках — для PostgreSQL и других баз данных, которые вы используете.