// Référence des erreurs PostgreSQL

PostgreSQL XX000 : erreur interne

PostgreSQL a rencontré une condition que ses développeurs considèrent comme impossible. Souvent une condition de course avec du DDL simultané, parfois un bug ou une corruption. Notez les détails.

SQLSTATE
XX000
Nom
internal_error
Catégorie
Erreur interne
Message d'erreur
cache lookup failed for relation 16397

Ce que cela signifie

XX000 (internal_error) est le code pour les erreurs internes levées avec elog(ERROR, ...), que PostgreSQL utilise pour des conditions qui ne devraient pas se produire en fonctionnement normal. Les messages sont concis et techniques, tels que cache lookup failed for relation 16397, could not find pathkey item to sort ou unexpected chunk number.

Certaines sont déclenchées par la suppression d'une table ou d'une fonction alors qu'une autre session l'utilisait. D'autres indiquent un bug dans PostgreSQL ou une extension, ou une corruption de données, surtout lorsqu'elles se répètent sur le même objet.

Causes courantes

  • DDL concurrent : un objet supprimé ou recréé tandis qu'une requête d'une autre session y faisait référence par OID.
  • Un bug dans PostgreSQL ou dans une extension, souvent corrigé dans une version mineure ultérieure.
  • Catalogue ou données de table corrompus après une défaillance matérielle ou de stockage.

Comment le corriger

  1. Réessayez l'instruction. S'il s'agissait d'une situation de concurrence avec une instruction DDL, elle réussit une fois que l'autre modification est terminée.

  2. Vérifiez que le serveur exécute la dernière version mineure de sa version majeure ; les versions mineures corrigent de nombreuses erreurs internes.

    SELECT version();
  3. Si l'erreur se répète sur une table, vérifiez qu'elle n'est pas corrompue (la amcheck l'extension vérifie les index B-arbre et, depuis PostgreSQL 14, les tables heap avec pg_amcheck), et restaurer à partir de la sauvegarde si nécessaire.

    CREATE EXTENSION IF NOT EXISTS amcheck;
    SELECT bt_index_check('orders_pkey');
  4. Si vous pouvez le reproduire, signalez-le à la liste des bugs de PostgreSQL avec la version, l’erreur complète avec \set VERBOSITY verbose, et un script.

Erreurs liées

Plus d'erreurs d'erreur interne

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.