// PostgreSQL 錯誤參考

PostgreSQL 54000:超出程式限制

觸及了硬性的實作上限,最常見是 B-tree 索引項目的值太大,或欄位數、函式引數過多。

SQLSTATE
54000
名稱
program_limit_exceeded
類別
已超出程式限制
錯誤訊息
index row size 3200 exceeds btree version 4 maximum 2704 for index "documents_body_idx"
DETAIL:  Index row references tuple (12,3) in relation "documents".
HINT:  Values larger than 1/3 of a buffer page cannot be indexed.
Consider a function index of an MD5 hash of the value, or use full text indexing.

它的意義

54000 (program_limit_exceeded)會在陳述式撞上 PostgreSQL 的固定上限時擲回。最常遇到的是 B-tree 條目的大小:索引的值必須塞得進 8 kB 頁面的大約三分之一(現行 B-tree 索引為 2704 位元組),所以長文字欄位上的唯一索引會在大值進來時失敗。

這一類的其他限制還包括:每個資料表最多 1600 個欄位,每個函式最多 100 個引數,以及選取清單中最多 1664 個項目。

常見原因

  • 一個 B-tree 索引(通常來自 UNIQUE 約束)用在可能存放大量資料的文字、JSON 或 bytea 欄位上。
  • 產生的查詢帶有數千個欄位或運算式。
  • 呼叫具有超過 100 個引數的函式,例如非常寬的 json_build_object.

如何修正

  1. 改為對值的雜湊建立索引,而不是對值本身建立;這在實務上仍能強制唯一性。

    DROP INDEX documents_body_idx;
    CREATE UNIQUE INDEX documents_body_md5_key ON documents (md5(body));
  2. 要在長文字裡搜尋,請用全文搜尋或 trigram 索引,別用 B-tree。

    CREATE INDEX documents_body_fts ON documents USING gin (to_tsvector('english', body));
  3. 超寬的資料可以把屬性存進更少的欄位(jsonb),並從資料列建立物件(to_jsonb(t)),而不是傳幾百個引數。

相關錯誤

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

// 錯誤更少,修復更快

在 SQLly 裡操作 PostgreSQL

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