PostgreSQL XX001: 데이터 손상
PostgreSQL이 무결성이나 체크섬 검사에 실패하는 데이터 페이지를 읽었습니다. 저장소 손상으로 취급하세요: 데이터를 보호한 다음 복원하거나 살려 내세요.
- SQLSTATE
XX001- 이름
data_corrupted- 카테고리
- 내부 오류
의미
XX001 (data_corrupted)는 디스크에서 읽은 페이지가 유효하지 않다는 뜻입니다: 헤더가 깨졌거나, 데이터 체크섬이 활성화된 경우 체크섬이 맞지 않거나, 파일이 테이블에 필요한 것보다 짧습니다 (could not read block ... read only 0 of 8192 bytes). 메시지에 있는 파일 경로 (base/<database oid>/<relfilenode>)는 테이블이나 인덱스를 식별합니다.
PostgreSQL 자체가 원인인 경우는 아주 드뭅니다. 흔한 원인은 고장 난 디스크나 컨트롤러, 쓰기 플러시를 했다고 거짓 말하는 스토리지, 쓰기 순서가 제대로 보장되지 않는 하드웨어에서의 충돌, 일관성 없이 복사되거나 복원된 파일입니다.
일반적인 원인
- 하드웨어나 스토리지 고장: 디스크, RAID 컨트롤러, SAN 또는 클라우드 볼륨.
- 쓰기 캐시가
fsync, 그 뒤 전원이 끊기거나 비정상 종료된 경우. fsync = off또는full_page_writes = off운영 환경에서.- 다음 없이 데이터 디렉터리를 복사하여 만든 백업
pg_basebackup또는 백업 API를 쓰지 않고 만든 백업, 또는 다른 소프트웨어가 건드린 파일.
해결 방법
-
어떤 복구든 시도하기 전에 먼저 멈추고 데이터 디렉터리 전체를 파일 단위로 복사해 두세요. 그래야 무슨 짓을 해도 상황이 더 나빠지지 않습니다.
-
파일이 어떤 객체에 속하는지 찾으세요.
SELECT relname, relkind FROM pg_class WHERE relfilenode = 16397;
-
인덱스라면 재구축하세요.
REINDEX INDEX CONCURRENTLY orders_pkey;
-
테이블이라면, 백업이나 복제본에서 복원하세요. 읽을 수 있는 행을 구하기 위한 마지막 수단으로,
zero_damaged_pages = on테이블을 복사해 내는 동안 PostgreSQL이 손상된 페이지를 건너뛰게 합니다(해당 행은 사라집니다).SET zero_damaged_pages = on; -- superuser, salvage only CREATE TABLE orders_salvage AS SELECT * FROM orders; RESET zero_damaged_pages;
-
하드웨어와 저장소 로그를 확인하고, 새 클러스터에는 데이터 체크섬을 활성화하세요(
initdb --data-checksums, 또는pg_checksums --enable중지된 클러스터에서) 손상이 조기에 감지됩니다.
관련 오류
XX000내부 오류58P01정의되지 않은 파일53100디스크가 가득 찼습니다824SQL Server: 논리적 일관성 기반 I/O 오류SQLITE_CORRUPTSQLite: 데이터베이스 디스크 이미지가 손상됨
코드와 메시지 텍스트의 출처는 다음과 같습니다 PostgreSQL 문서 부록 A: PostgreSQL 오류 코드. 전체 목록은 PostgreSQL 오류 목록 또는 모든 데이터베이스 오류 검색.
SQLly에서 PostgreSQL 작업하기
스키마를 아는 IntelliSense, 위험한 문장에 대한 가드레일, 명확한 오류 메시지를 갖춘 macOS, Windows, Linux용 네이티브 SQL 클라이언트입니다. PostgreSQL은 물론 평소 쓰는 다른 데이터베이스까지 지원합니다.