// Référence des erreurs PostgreSQL

PostgreSQL 54000 : limite du programme dépassée

Une limite d'implémentation stricte a été atteinte, le plus souvent une valeur trop grande pour une entrée d'index B-tree, ou trop de colonnes ou d'arguments de fonction.

SQLSTATE
54000
Nom
program_limit_exceeded
Catégorie
Limite du programme dépassée
Message d'erreur
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.

Ce que cela signifie

54000 (program_limit_exceeded) est levée lorsqu'une instruction atteint l'une des limites fixes de PostgreSQL. La plus fréquente est la taille des entrées B-tree : une valeur indexée doit tenir dans environ un tiers d'une page de 8 kB (2704 octets pour les index B-tree actuels), donc un index unique sur une colonne de texte long échoue dès qu'une grande valeur arrive.

Autres limites de cette classe : au plus 1 600 colonnes par table, 100 arguments par fonction et 1 664 entrées dans une liste de sélection.

Causes courantes

  • Un index B-tree (souvent issu d'une UNIQUE contrainte) sur une colonne texte, JSON ou bytea pouvant contenir des valeurs volumineuses.
  • Une requête générée comportant des milliers de colonnes ou d’expressions.
  • Appeler une fonction avec plus de 100 arguments, par exemple une fonction très large json_build_object.

Comment le corriger

  1. Indexez un hachage de la valeur au lieu de la valeur elle-même ; cela garantit encore l'unicité à des fins pratiques.

    DROP INDEX documents_body_idx;
    CREATE UNIQUE INDEX documents_body_md5_key ON documents (md5(body));
  2. Pour chercher dans de longs textes, utilisez la recherche plein texte ou des index trigram plutôt qu'un B-arbre.

    CREATE INDEX documents_body_fts ON documents USING gin (to_tsvector('english', body));
  3. Pour des données très larges, stockez les attributs dans moins de colonnes (jsonb), et construire des objets à partir des lignes (to_jsonb(t)) plutôt que de passer des centaines d'arguments.

Erreurs liées

Le code et le texte du message sont issus de Documentation PostgreSQL, annexe A : Codes d’erreur PostgreSQL. Parcourir la liste complète Liste des erreurs PostgreSQL ou Rechercher toutes les erreurs de base de données.

// moins d'erreurs, corrections plus rapides

Travailler sur PostgreSQL dans SQLly

Un client SQL natif pour macOS, Windows et Linux avec IntelliSense conscient du schéma, des garde-fous pour les instructions risquées et des messages d'erreur clairs, pour PostgreSQL et les autres bases de données que vous utilisez.