PostgreSQL 42P01:關聯不存在
PostgreSQL 找不到資料表、檢視或序列。通常是 search_path 上的結構描述設錯、名稱大小寫混合又加了引號,或連錯了資料庫。
- SQLSTATE
42P01- 名稱
undefined_table
它的意義
在 PostgreSQL 中,關聯(relation)泛指任何類似資料表的物件:資料表、檢視、實體化檢視、序列、索引或外部資料表。42P01 表示你使用的名稱無法對應到其中任何一個,而可用的結構描述列於你的 search_path (或你明確指定的結構描述)。
PostgreSQL 會把未加引號的名稱轉為小寫。建立為 "Orders" (含引號,大寫 O)就只能被引用為 "Orders",因此 SELECT * FROM Orders 它會尋找 orders 並且失敗。
常見原因
- 資料表所在的結構描述不在
search_path,例如sales.orders而路徑為"$user", public. - 資料表是以加了引號的大小寫混合名稱建立的(ORM 和 GUI 工具常見),但查詢沒有為它加引號。
- 你連線的資料庫與擁有該資料表的資料庫不同。PostgreSQL 無法只靠簡單名稱跨資料庫查詢。
- 資料表尚未建立,或是遷移失敗,或是在另一個資料庫中執行。
- 資料表名稱打錯字。
如何修正
-
檢查你目前的位置與搜尋路徑。
SELECT current_database(), current_schema(); SHOW search_path;
-
找出該資料表,無論其結構描述或大小寫為何。
SELECT table_schema, table_name FROM information_schema.tables WHERE lower(table_name) = 'orders';
-
以結構描述限定名稱,或將結構描述加入搜尋路徑。
SELECT * FROM sales.orders; SET search_path TO sales, public; -- permanently for a role: ALTER ROLE app SET search_path TO sales, public;
-
如果資料表建立時用了大寫,請一律精確加上引號,或一次性將它重新命名為小寫,之後就不再需要引號。
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 擴充功能,或連線到另一個資料庫。
相關錯誤
42703欄位不存在3F000架構不存在3D000資料庫不存在42501權限遭拒208SQL Server:無效的物件名稱1146MySQL:資料表不存在ORA-00942Oracle:資料表或檢視不存在
更多語法錯誤或存取規則違規錯誤
42601語法錯誤,發生在或靠近42846無法強制轉換42803欄位必須出現在 GROUP BY 子句中42830無效的外鍵42804資料類型不符42P18無法判斷參數的資料類型42883函式不存在42P02沒有參數
程式碼和訊息文字來自 PostgreSQL 文件,附錄 A:PostgreSQL 錯誤碼。瀏覽完整的 PostgreSQL 錯誤清單 或 搜尋每個資料庫錯誤.
在 SQLly 裡操作 PostgreSQL
適用於 macOS、Windows 和 Linux 的原生 SQL 客戶端,具備結構描述感知的 IntelliSense、高風險陳述式防護與清楚的錯誤訊息,適用於 PostgreSQL 和你使用的其他資料庫。