// Référence des erreurs PostgreSQL

PostgreSQL 42P01 : la relation n'existe pas

PostgreSQL ne trouve pas la table, la vue ou la séquence. En général, un mauvais schéma dans le search_path, un nom en casse mixte entre guillemets, ou la mauvaise base de données.

SQLSTATE
42P01
Nom
undefined_table
Catégorie
Erreur de syntaxe ou violation de règle d'accès
Message d'erreur
relation "orders" does not exist
LINE 1: SELECT * FROM orders;
                      ^

Ce que cela signifie

Dans PostgreSQL, une relation est tout objet de type table : une table, une vue, une vue matérialisée, une séquence, un index ou une table étrangère. 42P01 signifie que le nom que vous avez utilisé ne correspond à aucun objet, dans les schémas listés sur votre search_path (ou dans le schéma que vous avez nommé explicitement).

PostgreSQL convertit en minuscules les noms non entourés de guillemets. Une table créée comme "Orders" (entre guillemets, O majuscule) ne peut être désignée qu'en tant que "Orders", donc SELECT * FROM Orders cherche orders et échoue.

Causes courantes

  • La table est dans un schéma qui n'est pas sur le search_path, par exemple sales.orders alors que le chemin est "$user", public.
  • La table a été créée avec un nom entre guillemets en casse mixte (courant avec les ORM et les outils GUI) et la requête ne le met pas entre guillemets.
  • Vous êtes connecté à une base de données différente de celle qui contient la table. PostgreSQL ne peut pas interroger d’autres bases de données avec un simple nom.
  • La table n'a pas encore été créée, ou une migration a échoué ou a été exécutée dans une autre base de données.
  • Une faute de frappe dans le nom de la table.

Comment le corriger

  1. Vérifiez où vous êtes et quel est votre chemin de recherche.

    SELECT current_database(), current_schema();
    SHOW search_path;
  2. Trouvez la table, quel que soit son schéma ou sa casse.

    SELECT table_schema, table_name
    FROM information_schema.tables
    WHERE lower(table_name) = 'orders';
  3. Qualifiez le nom avec son schéma, ou ajoutez le schéma au chemin de recherche.

    SELECT * FROM sales.orders;
    SET search_path TO sales, public;
    -- permanently for a role:
    ALTER ROLE app SET search_path TO sales, public;
  4. Si la table a été créée avec des majuscules, mettez-la exactement entre guillemets, ou renommez-la une fois en minuscules pour qu'elle n'ait plus besoin de guillemets.

    SELECT * FROM "Orders";
    ALTER TABLE "Orders" RENAME TO orders;

Reproduisez-le en toute sécurité

SELECT * FROM table_that_does_not_exist;  -- ERROR: relation "table_that_does_not_exist" does not exist

Questions

La table existe, alors pourquoi PostgreSQL dit-il que la relation n'existe pas ?

Presque toujours, c'est le schéma ou la casse. Soit le schéma de la table n'est pas dans votre search_path, soit elle a été créée avec un nom en casse mixte entre guillemets et doit être écrite de la même manière. Interroger information_schema.tables avec lower(table_name) montre son véritable schéma et son orthographe exacte.

Puis-je sélectionner à partir d'une table dans une autre base de données ?

Pas directement. Chaque connexion PostgreSQL ne porte que sur une seule base de données. Utilisez les extensions postgres_fdw ou dblink, ou connectez-vous à l'autre base de données.

Erreurs liées

Plus d'erreurs de syntaxe ou de violation de règle d'accès

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.