// PostgreSQL 錯誤參考

PostgreSQL 42501:權限遭拒

目前的角色缺少陳述式所需的權限:針對資料表、結構描述、序列、函式或資料庫。請授予該權限,或使用具有該權限的角色連線。

SQLSTATE
42501
名稱
insufficient_privilege
類別
語法錯誤或存取規則違反
錯誤訊息
permission denied for table orders

它的意義

PostgreSQL 會檢查陳述式所觸及的每個物件的權限。42501 (insufficient_privilege)會指出物件的型別與名稱,例如 permission denied for table orders, permission denied for schema app 或 permission denied for sequence orders_id_seq。舊版本會顯示 relation 而不是 table.

每個層級都需要權限: USAGE 在結構描述上,然後 SELECT, INSERT, UPDATE 或 DELETE 在資料表上,還有 USAGE 在其背後的序列上,針對 serial 欄位,供插入時使用。

常見原因

  • 該角色從未獲得這項權限,或者授權範圍是其他資料表,而非目前使用的這一個。
  • 在下面這句之後建立的資料表 GRANT ... ON ALL TABLES IN SCHEMA,而它只涵蓋當時就已存在的資料表。
  • 否 USAGE 在結構描述上,或者自 PostgreSQL 15 起一般角色沒有 CREATE 在 public 一般角色的架構。
  • 插入到一個資料表,其 serial 欄位,但沒有 USAGE 在其序列上。
  • 變更或刪除非你擁有的物件(must be owner of table orders,同一套程式碼)。

如何修正

  1. 授予該角色所需的資料表與結構描述權限。

    GRANT USAGE ON SCHEMA app TO app_user;
    GRANT SELECT, INSERT, UPDATE, DELETE ON ALL TABLES IN SCHEMA app TO app_user;
    GRANT USAGE ON ALL SEQUENCES IN SCHEMA app TO app_user;
  2. 以預設權限涵蓋稍後建立的資料表(由建立資料表的角色設定)。

    ALTER DEFAULT PRIVILEGES IN SCHEMA app
        GRANT SELECT, INSERT, UPDATE, DELETE ON TABLES TO app_user;
  3. 檢視角色擁有的權限。

    SELECT has_table_privilege('app_user', 'app.orders', 'INSERT'),
           has_schema_privilege('app_user', 'app', 'USAGE');
  4. 在 PostgreSQL 15 及更新版本,授與 CREATE on public ,若角色需要在其中建立物件,就必須明確授權。

    GRANT CREATE ON SCHEMA public TO app_user;

相關錯誤

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

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

// 錯誤更少,修復更快

在 SQLly 裡操作 PostgreSQL

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