// PostgreSQL 錯誤參考

PostgreSQL 42P01:關聯不存在

PostgreSQL 找不到資料表、檢視或序列。通常是 search_path 上的結構描述設錯、名稱大小寫混合又加了引號,或連錯了資料庫。

SQLSTATE
42P01
名稱
undefined_table
類別
語法錯誤或存取規則違反
錯誤訊息
relation "orders" does not exist
LINE 1: SELECT * FROM orders;
                      ^

它的意義

在 PostgreSQL 中,關聯(relation)泛指任何類似資料表的物件:資料表、檢視、實體化檢視、序列、索引或外部資料表。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 說關聯不存在?

幾乎都是 schema 或大小寫的問題:不是資料表的 schema 不在你的 search_path 上,就是建立時用了帶引號的大小寫混合名稱,查詢時必須以同樣方式加引號。用 lower(table_name) 查 information_schema.tables,就能看到它真正的 schema 和拼寫。

我可以對另一個資料庫裡的資料表執行 SELECT 嗎?

無法直接跨庫連線。每個 PostgreSQL 連線只對應一個資料庫;可使用 postgres_fdw 或 dblink 擴充功能,或連線到另一個資料庫。

相關錯誤

更多語法錯誤或存取規則違規錯誤

程式碼和訊息文字來自 PostgreSQL 文件,附錄 A:PostgreSQL 錯誤碼。瀏覽完整的 PostgreSQL 錯誤清單 或 搜尋每個資料庫錯誤.

// 錯誤更少,修復更快

在 SQLly 裡操作 PostgreSQL

適用於 macOS、Windows 和 Linux 的原生 SQL 客戶端,具備結構描述感知的 IntelliSense、高風險陳述式防護與清楚的錯誤訊息,適用於 PostgreSQL 和你使用的其他資料庫。