| PostgreSQL 8.3.3문서 | ||||
|---|---|---|---|---|
| Prev | Fast Backward | Fast Forward | Next | |
pg_resetxlog [-f] [-n] [-o oid ] [-x xid ] [-e xid_epoch ] [-m mxid ] [-O mxoff ] [-l timelineid , fileid , seg ] datadir
pg_resetxlog는 선행 기입 로그(WAL)를 소거해, 선택적으로 pg_control파일 내에 보존된 제어 정보의 일부를 초기화합니다. 이 기능은, 이러한 파일이 파손했을 경우에 필요하게 됩니다. 이러한 파손 등의 원인으로 서버를 시작할 수 없을 때, 마지막 수단으로서 이 기능을 사용해 주세요.
이 커멘드를 실행한 후에, 서버를 시작해야만 합니다. 그러나 부분적으로 커밋된 트랜잭션(transaction) 때문에 데이터베이스의 데이터에 모순이 일어날 가능성이 있는 것에 주의해 주세요. 명령의 실행 후는, 데이터를 즉시 덤프 하고 initdb를 실행해, 리로드 해야 합니다. 리로드 후, 모순이 없는지 검사하고 필요에 따라서 정정해 주세요.
이 유틸리티의 실행에는 데이터 디렉토리에의 읽기/쓰기 액세스 권한이 필요하기 때문에, 서버를 설치한 사용자만이 실행할 수 있습니다. 안전의 이유로 명령라인에 데이터 디렉토리를 지정해야 합니다. pg_resetxlog는 PGDATA환경 변수를 사용하지 않습니다.
pg_resetxlog가 pg_control에 대한 유효한 데이터를 판별할 수 없는 경우, -f(강제) 스위치를 지정하면 강제적으로 처리를 진행시킬 수가 있습니다. 그 경우, 잃어버린 데이터는 무난한 값으로 대용됩니다. 대부분의 필드에서는 적절한 값이 사용되지만, 다음의 OID, 다음의 트랜잭션(transaction) ID와 신시대(epoch), 멀티 트랜잭션(transaction) ID와 그 오프셋(offset), WAL 시작 주소, 데이터베이스 로케일 필드의 값에 대해서는, 수동의 조작이 필요한 경우가 있습니다. 최초의 6개에 대해서는 아래와 같이 설명하는 스위치를 사용해 설정할 수가 있습니다. pg_resetxlog의 소유하고 있는 환경은 로케일 필드에서 추측되므로,LANG등의 값이 initdb가 실행된 환경과 일치하도록 주의해 주세요. 만약 이러한 필드에 대해서 올바른 값을 결정할 수 없는 경우에도 -f를 사용할 수가 있지만, 이 경우는 회복한 데이터베이스를 보통 때 보다 더 주의 깊게 검사할 필요가 있습니다. 반드시, 즉시 덤프 및 리로드를 실시해 주세요. Do not 는 덤프를 실시하기 전에 데이터 변경 등의 조작을 실시해야 합니다. 이것을 실시하면, 파손 상태가 한층 더 악화됩니다.
-o, -x, -e, -m, -O, -l의 각 스위치를 사용하면, 다음의 OID, 다음의 트랜잭션(transaction) ID, 다음의 트랜잭션(transaction) ID의 신시대, 다음의 멀티 트랜잭션(transaction) ID, 다음의 멀티 트랜잭션(transaction)의 오프셋(offset), WAL 시작 주소의 값을 수동으로 설정할 수가 있습니다. 이 조작은 pg_resetxlog가 pg_control의 읽기에 의해 적절한 값을 판별할 수 없는 경우에게만 필요합니다. 안전한 값을 얻으려면 이하와 같이 합니다.
다음의 트랜잭션(transaction) ID(-x)의 안전한 값은, 데이터 디렉토리 아래의 pg_clog디렉토리 내에서 가장 큰 숫자를 가지는 파일명을 찾는 것으로 결정할 수가 있습니다. 그 값에 1을 더해 1048576으로 곱셈합니다. 파일명은 16 진수이므로, 통상, 스위치의 값도 16 진수로 지정하는 것이 간단합니다. 예를 들면,0011이 pg_clog로 가장 큰 엔트리이면,-x 0x1200000가 됩니다(뒤로 제로를 5개 붙이면(자), 1048576으로 곱셈한 것이 됩니다).
다음의 멀티 트랜잭션(transaction) ID(-m) 의 안전한 값은, 데이터 디렉토리 이하의pg_multixact/offsets 디렉토리 내에서 가장 큰 숫자를 가지는 파일명을 찾는 것으로 결정할 수가 있습니다. 그 값에 1을 더해 65536으로 곱셈합니다. 위와 같이, 파일명은 16 진수이므로, 통상, 스윗치의 값도 16 진수로 지정하는 것이 간단합니다. 여기에서는, 4개의 제로를 붙여 주세요.
다음의 멀티 트랜잭션(transaction) 오프셋(offset)(-O)의 안전한 값은, 데이터 디렉토리 이하의pg_multixact/members디렉토리 내에서 가장 큰 숫자를 가지는 파일명을 찾는 것으로 결정할 수가 있습니다. 그 값에 1을 더해 65536으로 곱셈합니다. 위와 같이, 파일명은 16 진수이므로, 통상, 스윗치의 값도 16 진수로 지정하는 것이 간단합니다. 여기에서는, 4개의 제로를 붙여 주세요.
WAL 시작 주소(-l)는 데이터 디렉토리 이하의pg_xlog에 현재 존재하는 WAL 세그먼트(segment) 파일명의 어느 번호보다 커야 합니다. 이 이름도 16 진수로, 3개의 부분으로 나누어져 있습니다. 최초의 부분은"시계열 ID"로, 통상, 이 값은 변경해야 하지는 않습니다. 3번째의 부분에는 255(0xFF)보다 큰 값을 선택하지 않아야 합니다. 255를 넘을 때는, 2번째의 부분에 1을 더해 3번째의 부분을 0에 되돌려 주세요. 예를 들면,pg_xlog내에서 최대의 엔트리가00000001000000320000004A인 경우는, -l 0x1, 0x32, 0x4B로 지정하면 문제없이 동작합니다. 그러나 최대의 엔트리가000000010000003A000000FF의 경우는 -l 0x1, 0x3B, 0x0, 또는 그 이상의 값을 지정해 주세요.
데이터베이스내의 OID의 최대치보다 큰 다음의 OID를 결정하려면, 상기와 같이 간단한 방법은 없습니다. 그러나, 다행히도, 다음의 OID가 올바르게 설정되어 있을지 어떨지는, 그만큼 중요하지는 않습니다.
--> pg_resetxlog로 설정되는 필드를 제외하고 트랜잭션(transaction) ID의 신시대는 실제로는 데이터베이스내에 저장되지 않습니다. 그 때문에, 데이터베이스 자신이 문제로 하지 않는 한, 임의의 값으로 동작합니다. Slony-I등의 응답 시스템이 확실히 올바르게 동작하도록 이 값을 조정해야 할 필요가 있습니다. 그 경우, 적절한 값은 응답 시스템의 아래에서 복제된 데이터베이스 상태로부터 얻을 수 있을 것입니다.
-n(조작 없음) 스위치를 지정하면 pg_resetxlog는pg_control로부터 재구축 한 값을 출력해, 아무것도 변경하지 않고 종료합니다. 이것은 주로 디버그와 목적으로 한 툴이지만 pg_resetxlog를 실제로 진행하기 전의 검사라고 해도 유용할 수 있습니다.