// PostgreSQL 錯誤參考
PostgreSQL 3F000:結構描述不存在
陳述式指定了目前資料庫中不存在的 schema,或要在 search_path 上沒有任何 schema 時建立物件。
- SQLSTATE
3F000- 名稱
invalid_schema_name- 類別
- 無效的架構名稱
它的意義
結構描述是單一資料庫內的命名空間。3F000 表示限定名稱(sales.orders)或在 SET search_path 在你所連線的資料庫中不存在。結構描述名稱遵循與其他識別碼相同的大小寫規則:未加引號的名稱會折為小寫。
相關案例是 no schema has been selected to create in,當 CREATE TABLE 執行時搭配一個 search_path 其中不含任何現有架構。
常見原因
- 這個結構描述尚未在這個資料庫中建立(每個資料庫都有自己的結構描述)。
- 加引號的混合大小寫結構描述名稱,例如
"Sales"未使用引號引用。 - 連錯了資料庫。
- A
search_path只指定了不存在的架構。
如何修正
-
列出此資料庫中的結構描述。
SELECT nspname FROM pg_namespace ORDER BY nspname;
-
建立結構描述,並可視需要由應用程式角色擁有。
CREATE SCHEMA IF NOT EXISTS sales AUTHORIZATION app;
-
把搜尋路徑指向確實存在的結構描述。
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 和你使用的其他資料庫。