// PostgreSQL 錯誤參考

PostgreSQL 3D000:資料庫不存在

連線指定的資料庫不在這台伺服器上。通常是拼字錯誤、大小寫不符,或客戶端把資料庫名稱預設成使用者名稱。

SQLSTATE
3D000
名稱
invalid_catalog_name
類別
無效的目錄名稱
錯誤訊息
database "shop" does not exist

它的意義

每個 PostgreSQL 連線都只連到一個資料庫,資料庫名稱寫在連線字串中。如果你連上的伺服器沒有名稱相符的資料庫,登入就會以 3D000 錯誤結束。

一旦使用引號建立,資料庫名稱就是區分大小寫的,許多用戶端會填入一個預設值: psql 而 libpq 在未指定資料庫名稱時,會拿使用者名稱當作資料庫名稱,因此 psql -U app 會嘗試開啟一個名為 app.

常見原因

  • 打錯字,或資料庫是用引號包住的混合大小寫名稱建立的,例如 "Shop".
  • 未指定資料庫,因此用戶端以使用者名稱作為資料庫名稱。
  • 連到錯誤的伺服器或連接埠(另一個執行個體、另一個容器),而該資料庫從未在那裡建立。
  • 資料庫已被刪除或尚未由設定腳本建立。

如何修正

  1. 連線到必定存在的資料庫,例如 postgres,並列出資料庫。

    -- psql -h db -U app -d postgres
    SELECT datname FROM pg_database ORDER BY datname;
  2. 如果資料庫本應存在,就把它建立起來。

    CREATE DATABASE shop OWNER app;
  3. 在連線字串中明確傳遞資料庫名稱,例如 postgresql://app@db:5432/shop 或 psql -d shop.

  4. 如果它是用大寫字母建立的,請使用精確名稱。在 URL 或 -d 選項中不需要引號: psql -d Shop.

問題

為什麼我只給了使用者名稱,psql 卻說資料庫不存在?

當未指定資料庫時,psql 會連線到與使用者同名的資料庫。請加上 -d postgres 或你想要的資料庫。

相關錯誤

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

// 錯誤更少,修復更快

在 SQLly 裡操作 PostgreSQL

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