// Referencia de errores de PostgreSQL

PostgreSQL 54000: se superó el límite del programa

Se alcanzó un límite estricto de implementación, normalmente un valor demasiado grande para una entrada de índice B-tree, o demasiadas columnas o argumentos de función.

SQLSTATE
54000
Nombre
program_limit_exceeded
Categoría
Límite del programa excedido
Mensaje de error
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.

Qué significa

54000 (program_limit_exceeded) se produce cuando una instrucción choca con uno de los límites fijos de PostgreSQL. El más común es el tamaño de la entrada del B-tree: un valor indexado debe caber en aproximadamente un tercio de una página de 8 kB (2704 bytes en los índices B-tree actuales), de modo que un índice único sobre una columna de texto largo falla cuando llega un valor grande.

Otros límites de esta clase: como máximo 1600 columnas por tabla, 100 argumentos por función y 1664 entradas en una lista de selección.

Causas comunes

  • Un índice B-tree (a menudo de una UNIQUE restricción) en una columna de texto, JSON o bytea que puede contener valores grandes.
  • Una consulta generada con miles de columnas o expresiones.
  • Llamar a una función con más de 100 argumentos, por ejemplo, una muy amplia json_build_object.

Cómo solucionarlo

  1. Indexa un hash del valor en lugar del valor en sí; en la práctica, esto sigue garantizando la unicidad.

    DROP INDEX documents_body_idx;
    CREATE UNIQUE INDEX documents_body_md5_key ON documents (md5(body));
  2. Para buscar dentro de texto largo, usa búsqueda de texto completo o índices de trigramas en lugar de un B-tree.

    CREATE INDEX documents_body_fts ON documents USING gin (to_tsvector('english', body));
  3. Para datos muy anchos, almacena atributos en menos columnas (jsonb), y construir objetos a partir de filas (to_jsonb(t)) en lugar de pasar cientos de argumentos.

Errores relacionados

El código y el texto del mensaje son de documentación de PostgreSQL, Apéndice A: Códigos de error de PostgreSQL. Explora la lista completa de Lista de errores de PostgreSQL o buscar cada error de base de datos.

// menos errores, correcciones más rápidas

Trabajar con PostgreSQL en SQLly

Un cliente SQL nativo para macOS, Windows y Linux con IntelliSense que conoce el esquema, protecciones para las instrucciones de riesgo y mensajes de error claros, para PostgreSQL y las demás bases de datos que uses.