PostgreSQL 54000: プログラムの上限を超えました
実装上の厳格な上限に達しました。多くの場合、B-tree インデックスのエントリに対して値が大きすぎるか、列数や関数の引数が多すぎることが原因です。
- SQLSTATE
54000- 名前
program_limit_exceeded- カテゴリ
- プログラムの上限を超過しました
意味
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.
修正方法
-
値そのものではなく値のハッシュにインデックスを作成します。実用上は、これでも一意性が強制されます。
DROP INDEX documents_body_idx; CREATE UNIQUE INDEX documents_body_md5_key ON documents (md5(body));
-
長いテキストの内部検索には、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 をはじめ、お使いの他のデータベースにも対応します。