// PostgreSQL 錯誤參考

PostgreSQL 3F000:結構描述不存在

陳述式指定了目前資料庫中不存在的 schema,或要在 search_path 上沒有任何 schema 時建立物件。

SQLSTATE
3F000
名稱
invalid_schema_name
類別
無效的架構名稱
錯誤訊息
schema "sales" does not exist

它的意義

結構描述是單一資料庫內的命名空間。3F000 表示限定名稱(sales.orders)或在 SET search_path 在你所連線的資料庫中不存在。結構描述名稱遵循與其他識別碼相同的大小寫規則:未加引號的名稱會折為小寫。

相關案例是 no schema has been selected to create in,當 CREATE TABLE 執行時搭配一個 search_path 其中不含任何現有架構。

常見原因

  • 這個結構描述尚未在這個資料庫中建立(每個資料庫都有自己的結構描述)。
  • 加引號的混合大小寫結構描述名稱,例如 "Sales" 未使用引號引用。
  • 連錯了資料庫。
  • A search_path 只指定了不存在的架構。

如何修正

  1. 列出此資料庫中的結構描述。

    SELECT nspname FROM pg_namespace ORDER BY nspname;
  2. 建立結構描述,並可視需要由應用程式角色擁有。

    CREATE SCHEMA IF NOT EXISTS sales AUTHORIZATION app;
  3. 把搜尋路徑指向確實存在的結構描述。

    SET search_path TO sales, public;

安全地重現問題

SELECT * FROM no_such_schema.t;  -- ERROR: schema "no_such_schema" does not exist

相關錯誤

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

// 錯誤更少,修復更快

在 SQLly 裡操作 PostgreSQL

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