// PostgreSQL 錯誤參考
PostgreSQL 54000:超出程式限制
觸及了硬性的實作上限,最常見是 B-tree 索引項目的值太大,或欄位數、函式引數過多。
- SQLSTATE
54000- 名稱
program_limit_exceeded- 類別
- 已超出程式限制
它的意義
54000 (program_limit_exceeded)會在陳述式撞上 PostgreSQL 的固定上限時擲回。最常遇到的是 B-tree 條目的大小:索引的值必須塞得進 8 kB 頁面的大約三分之一(現行 B-tree 索引為 2704 位元組),所以長文字欄位上的唯一索引會在大值進來時失敗。
這一類的其他限制還包括:每個資料表最多 1600 個欄位,每個函式最多 100 個引數,以及選取清單中最多 1664 個項目。
常見原因
- 一個 B-tree 索引(通常來自
UNIQUE約束)用在可能存放大量資料的文字、JSON 或 bytea 欄位上。 - 產生的查詢帶有數千個欄位或運算式。
- 呼叫具有超過 100 個引數的函式,例如非常寬的
json_build_object.
如何修正
-
改為對值的雜湊建立索引,而不是對值本身建立;這在實務上仍能強制唯一性。
DROP INDEX documents_body_idx; CREATE UNIQUE INDEX documents_body_md5_key ON documents (md5(body));
-
要在長文字裡搜尋,請用全文搜尋或 trigram 索引,別用 B-tree。
CREATE INDEX documents_body_fts ON documents USING gin (to_tsvector('english', body)); -
超寬的資料可以把屬性存進更少的欄位(
jsonb),並從資料列建立物件(to_jsonb(t)),而不是傳幾百個引數。
相關錯誤
程式碼和訊息文字來自 PostgreSQL 文件,附錄 A:PostgreSQL 錯誤碼。瀏覽完整的 PostgreSQL 錯誤清單 或 搜尋每個資料庫錯誤.
// 錯誤更少,修復更快
在 SQLly 裡操作 PostgreSQL
適用於 macOS、Windows 和 Linux 的原生 SQL 客戶端,具備結構描述感知的 IntelliSense、高風險陳述式防護與清楚的錯誤訊息,適用於 PostgreSQL 和你使用的其他資料庫。