Skip to content

Commit 866908c

Browse files
committed
Add documentation about --keep-data-generations retention behavior (#312)
1 parent e2ab139 commit 866908c

2 files changed

Lines changed: 2 additions & 0 deletions

File tree

docs/index-ja.html

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1093,6 +1093,7 @@ <h1 id="restrictions">使用上の注意と制約</h1>
10931093
<li>pg_rmanがバックアップ取得中に異常終了した場合、PostgreSQLサーバはオンライン・バックアップ取得中のステータスのままになってしまうことがあります。その場合は、手動で"SELECT pg_stop_backup()&ldquo;を行う必要があります。</li>
10941094
<li>pg_rmanは増分バックアップ取得の際に、対象データベースのタイムラインをチェックして増分バックアップのベースとなる全体バックアップのタイムラインと一致しているかをチェックします。しかし、全く異なるデータベースだがタイムラインが同じというデータベースを指定してしまうと、pg_rmanはそれに気づかず、誤った増分バックアップを取得してしまいます。</li>
10951095
<li><code>--keep-data-generations</code>を0に指定してバックアップを取得する場合、現在取得したバックアップファイルを含めて、すべてのバックアップファイルが削除されます。<code>--keep-srvlog-files</code><code>--keep-srvlog-days</code>も同じです。</li>
1096+
<li><code>--keep-data-generations</code>を1以上に指定した場合、最新のフルバックアップは削除対象に含まれないため、指定した世代数よりも1つ多くのフルバックアップが保持されます。</li>
10961097
</ul>
10971098

10981099

docs/index.html

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1082,6 +1082,7 @@ <h1 id="restrictions">Restrictions</h1>
10821082
<li>If there are some unreadable files/directories in database cluster directory, WAL directory or archived WAL directory, the backup or restore would be failed.</li>
10831083
<li>When taking an incremental backup, pg_rman check the timeline ID of the target database whether it is the same with the one of the full backup in backup list. But, pg_rman does not check whether the data itself is same with the full backup in backup list. So, you can take an incremental backup over the full backup against the database which has the same timeline ID but has different data.</li>
10841084
<li>When pg_rman backup with <code>--keep-data-generations 0</code>, all backup files will be deleted, including the current backup file. <code>--keep-srvlog-files</code><code>--keep-srvlog-days</code> is same to <code>--keep-data-generations</code>.</li>
1085+
<li>When <code>--keep-data-generations</code> is set to 1 or more, the latest full backup is not included in the deletion target, so one more full backup than the specified number of generations is retained.</li>
10851086
</ul>
10861087

10871088

0 commit comments

Comments
 (0)