// 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 ツリーのエントリサイズです。インデックス付きの値は 8 kB ページの約 3 分の 1 に収まる必要があり(現在の B ツリーインデックスでは 2704 バイト)、そのため、長いテキスト列に対する一意インデックスは、大きな値が入ってきたときに失敗します。

同じ種類の制限はほかにも、テーブルあたり最大 1600 列、関数あたり 100 引数、選択リストで 1664 項目などがあります。

よくある原因

  • B-tree インデックス(多くは UNIQUE 制約)。大きな値を保持できるtext、JSON、bytea列に対して。
  • 数千の列や式で生成されたクエリ。
  • 100 個を超える引数を持つ関数の呼び出し。たとえば非常に幅の広い json_build_object.

修正方法

  1. 値そのものではなく値のハッシュにインデックスを作成します。実用上は、これでも一意性が強制されます。

    DROP INDEX documents_body_idx;
    CREATE UNIQUE INDEX documents_body_md5_key ON documents (md5(body));
  2. 長いテキストの内部検索には、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 をはじめ、お使いの他のデータベースにも対応します。