// PostgreSQL 오류 참조

PostgreSQL XX000: 내부 오류

PostgreSQL이 개발자들이 일어날 리 없다고 여기는 상황에 걸렸습니다. 대개는 동시 DDL과의 경합, 때로는 버그나 손상입니다. 세부 내용을 기록해 두세요.

SQLSTATE
XX000
이름
internal_error
카테고리
내부 오류
오류 메시지
cache lookup failed for relation 16397

의미

XX000 (internal_error)는 다음과 함께 발생하는 내부 오류의 코드입니다 elog(ERROR, ...), PostgreSQL이 정상 동작 중에는 일어나면 안 되는 상황에 쓰는 코드입니다. 메시지는 짧고 기술적인 편인데, 예를 들면 다음과 같습니다: cache lookup failed for relation 16397, could not find pathkey item to sort 또는 unexpected chunk number.

어떤 경우에는 다른 세션이 사용 중일 때 테이블이나 함수가 삭제되면 발생합니다. 다른 경우에는 PostgreSQL이나 확장 프로그램의 버그, 또는 데이터 손상을 가리키며, 특히 동일한 객체에서 반복될 때 그렇습니다.

일반적인 원인

  • 동시 DDL: 다른 세션의 쿼리가 OID로 참조하는 동안 객체가 삭제되거나 다시 생성됨.
  • PostgreSQL이나 확장 프로그램의 버그로, 이후 마이너 릴리스에서 흔히 수정됩니다.
  • 하드웨어 또는 저장 장치 고장 후 손상된 카탈로그 또는 테이블 데이터.

해결 방법

  1. 명령문을 다시 시도하십시오. DDL과의 경합이었다면 다른 변경이 끝난 후에 성공합니다.

  2. 서버가 주요 버전의 최신 마이너 릴리스를 실행하는지 확인하세요. 마이너 릴리스는 많은 내부 오류를 수정합니다.

    SELECT version();
  3. 오류가 한 테이블에서만 반복된다면 손상 여부를 확인하세요( amcheck 확장은 B-트리 인덱스를 검증하며, PostgreSQL 14부터는 힙 테이블도 pg_amcheck), 그리고 필요하면 백업에서 복원하세요.

    CREATE EXTENSION IF NOT EXISTS amcheck;
    SELECT bt_index_check('orders_pkey');
  4. 재현할 수 있다면 버전과 전체 오류, 그리고 다음을 포함해 PostgreSQL 버그 목록에 보고하세요 \set VERBOSITY verbose, 그리고 스크립트.

관련 오류

그 밖의 내부 오류

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

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

SQLly에서 PostgreSQL 작업하기

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