pg_waldump — PostgreSQL 데이터베이스 클러스터 미리-쓰기 로그를 사람이 읽을 수 있도록 덤프
pg_waldump [옵션...] [시작조각 [마침조각]]
pg_waldump 명령은 미리-쓰기 로그를
덤프한다. 이 덤프 내용은 서버 문제점을 추적하는데 이용하거나,
미리-쓰기 로그를 공부하는데 이용된다.
이 명령은 데이터베이스 서버를 실행한 OS 사용자만 실행할 수 있다. 데이터 디렉터리는 이 사용자만 사용할 수 있기 때문이다.
다음은 위치와 출력 양식을 지정하는 명령행 옵션들이다:
시작조각덤프를 시작할 첫 로그 조각 파일을 지정한다. 여기서 다음에 읽을 조각 파일의 경로와, 타임라인을 내부적으로 결정한다.
마침조각지정한 로그 조각 파일까지만 덤프하고 멈춘다.
-b--bkp-details백업 블럭에 대한 자세한 정보를 출력한다.
-e end--end=end로그 스트림의 끝까지 읽지 않고, 지저항 WAL 위치까지만 읽고 멈춘다.
-f--followWAL 파일을 끝까지 읽었다면, 새로운 WAL 파일이 생겼는지, 1초 간격으로 확인하다, 생겼으면 그것을 계속해서 덤프 한다.
-n 최대수--limit=최대수지정한 최대 레코드 수만큼 출력하고 멈춘다.
-p 경로--path=경로
읽을 로그 조각 파일이 있는 디렉터리.
일반적으로 pg_wal 디렉터리 경로를
지정한다. pg_wal 디렉터리는
PGDATA 디렉터리의 하위 디렉터리다.
이 옵션을 사용하지 않으면, 현재 디렉터리나,
현재 디렉터리 안에 있는 pg_wal 디렉터리에서
덤프할 조각 파일을 찾는다.
-q--quiet오류 외에는 어떤 출력도 하지 않는다. 이 옵션은 WAL 레코드들이 모두 정상 구조로 되어있는지 확인하는데, 유용한다. 이 옵션으로 그 레코드 내용이 바른지는 확인할 수 없다.
-r 리소스--rmgr=리소스
지정한 리소스 관리자가 만든 레코드만 출력한다.
이 옵션 값으로 list를 사용하면,
사용할 수 있는 모든 리소스 이름을 보여주고 마친다.
-s 시작위치--start=시작위치덤프를 시작할 WAL 위치. 이 옵션을 사용하지 않으며, 지정한 조각 파일의 출력할 수 있는 첫 레코드부터 덤프한다.
-t 타임라인--timeline=타임라인
타임라인 지정. 기본값은 시작조각 파일의 타임라인을
사용할 수 있으면 그것을 쓰고, 사용할 수 없으면, 1이다.
-V--versionpg_waldump 버전을 보여주고 마친다.
-x xid--xid=xid지정한 트랜잭션 ID 관련 레코드만 출력한다.
-z--stats[=record]개별 레코드 정보 대신에, 요약한 통계 정보를 보여준다. (레코드와 full-page 이미지의 크기, 개수) 선택적으로 리소스 관리자별이 아닌, 레코드 단위의 통계 정보를 보여준다.
-?--helppg_waldump 명령에서 사용할 수 있는 명령행 옵션 도움말을 보여주고 마친다.
PGDATA
Data directory; see also the -p option.
PG_COLOR
Specifies whether to use color in diagnostic messages. Possible values
are always, auto and
never.
서버가 실행 중일 때는 잘못된 출력 결과를 보여줄 수 있다.
기본적으로 단일 타임라인 레코드만 출력한다. 다른 타임라인 레코드는 무시된다.
pg_waldump 명령은
.partial 확장자 WAL 파일은 읽을 수 없다.
.partial 파일을 읽어야 한다면, 그 확장자가 없는
이름으로 바꾸어 사용해야 한다.