// PostgreSQL エラーリファレンス

PostgreSQL 42P01: リレーションが存在しません

PostgreSQL がテーブル、ビュー、シーケンスを見つけられません。多くの場合、search_path 上のスキーマ違い、引用符で囲んだ大文字小文字混在の名前、またはデータベース違いのいずれかが原因です。

SQLSTATE
42P01
名前
undefined_table
カテゴリ
構文エラーまたはアクセス規則違反
エラーメッセージ
relation "orders" does not exist
LINE 1: SELECT * FROM orders;
                      ^

意味

PostgreSQL では、リレーションはテーブルのようなオブジェクトすべてを指します。テーブル、ビュー、マテリアライズドビュー、シーケンス、インデックス、外部テーブルです。42P01 は、使用した名前が、次に記載されたスキーマ内のいずれにも解決されないことを意味します search_path (または明示的に指定したスキーマ内)。

PostgreSQL は、引用符のない名前を小文字に変換します。次のように作成されたテーブル "Orders" (引用符付き、大文字の O)は、次としてしか参照できません "Orders"、そのため SELECT * FROM Orders 次を探します orders 失敗します。

よくある原因

  • テーブルは、次の設定に含まれていないスキーマにあります search_path、たとえば sales.orders パスが次の間 "$user", public.
  • テーブルは引用符付きの大文字小文字混在の名前(ORM や GUI ツールでよくあります)で作成されていて、クエリではその名前に引用符を付けていません。
  • 接続先が、そのテーブルのあるデータベースではありません。PostgreSQLでは、単純な名前のままではデータベースをまたいでクエリできません。
  • テーブルがまだ作成されていないか、マイグレーションが失敗したか、別のデータベースで実行されました。
  • テーブル名の入力ミス。

修正方法

  1. 現在の場所と検索パスを確認してください。

    SELECT current_database(), current_schema();
    SHOW search_path;
  2. スキーマや大文字小文字に関係なく、テーブルを見つけます。

    SELECT table_schema, table_name
    FROM information_schema.tables
    WHERE lower(table_name) = 'orders';
  3. 名前をスキーマで修飾するか、スキーマを検索パスに追加します。

    SELECT * FROM sales.orders;
    SET search_path TO sales, public;
    -- permanently for a role:
    ALTER ROLE app SET search_path TO sales, public;
  4. 大文字を使ってテーブルを作成した場合は、正確にクォートするか、引用符が不要になるよう一度小文字に名前を変更してください。

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

安全に再現する

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

質問

テーブルは存在するのに、なぜ PostgreSQL は「relation does not exist」と言うのですか?

原因はほとんどの場合、スキーマか大文字と小文字のいずれかです。テーブルのスキーマが search_path に含まれていないか、引用符で囲んだ大文字小文字混在の名前で作成されていて、同じ方法で引用符で囲む必要があります。lower(table_name) を指定して information_schema.tables にクエリを実行すると、実際のスキーマと表記が確認できます。

別のデータベースのテーブルから SELECT できますか?

直接はできません。PostgreSQL の各接続は 1 つのデータベースに対するものです。postgres_fdw や dblink の拡張機能を使うか、もう一方のデータベースに接続してください。

関連エラー

その他の構文エラーまたはアクセス規則違反のエラー

コードとメッセージのテキストは、 PostgreSQL ドキュメントの付録 A: PostgreSQL エラーコード。全容は次で参照 PostgreSQL エラーリスト または すべてのデータベースエラーを検索.

// エラーが減り、修正も速く

SQLly で PostgreSQL を操作する

macOS、Windows、Linux 用のネイティブ SQL クライアント。スキーマを認識する IntelliSense、危険なステートメントへのガードレール、分かりやすいエラーメッセージを備え、PostgreSQL をはじめ、お使いの他のデータベースにも対応します。