// PostgreSQL 오류 참조

PostgreSQL 54000: 프로그램 한도 초과

구현상 하드 한도에 도달한 경우입니다. 대개는 B-트리 인덱스 항목에 담기엔 너무 큰 값이거나, 열 또는 함수 인수가 너무 많은 경우입니다.

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-트리 인덱스(흔히 다음에서 유래 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. 긴 텍스트 안에서 검색할 때는 B-트리 대신 전체 텍스트 검색 또는 트라이그램 인덱스를 사용하세요.

    CREATE INDEX documents_body_fts ON documents USING gin (to_tsvector('english', body));
  3. 열이 매우 많은 데이터는 속성을 더 적은 수의 열에 담습니다(jsonb), 그리고 행에서 객체를 만듭니다(to_jsonb(t)) 수백 개의 인자를 넘기는 대신입니다.

관련 오류

코드와 메시지 텍스트의 출처는 다음과 같습니다 PostgreSQL 문서 부록 A: PostgreSQL 오류 코드. 전체 목록은 PostgreSQL 오류 목록 또는 모든 데이터베이스 오류 검색.

// 오류는 줄이고, 수정은 빠르게

SQLly에서 PostgreSQL 작업하기

스키마를 아는 IntelliSense, 위험한 문장에 대한 가드레일, 명확한 오류 메시지를 갖춘 macOS, Windows, Linux용 네이티브 SQL 클라이언트입니다. PostgreSQL은 물론 평소 쓰는 다른 데이터베이스까지 지원합니다.