PRUNE HISTORY/LOGFILE コマンド

PRUNE HISTORY/LOGFILEコマンドは、リカバリー履歴ファイルから項目を削除したり、アクティブ・ログ・ファイル・パスからログ・ファイルを削除したりするために使用します。リカバリー履歴ファイルからの項目の削除は、ファイルが非常に大きくなったり保持期間が長くなっている場合に必要になることがあります。

PRUNE HISTORY コマンドはヒストリー・ファイルから項目を削除しますが、デフォルトでは、このコマンドは常に最新のリストア・セットに属する項目を保持します。これは、万が一障害が発生した場合にも、データベースをリカバリーできるようにするためです。最新のリストア・セットは、最新の完全なデータベース・バックアップ・イメージに属する項目と、そのイメージに関連付けられたその他のオブジェクト (例えば、ログ・アーカイブ、ロード・コピー・イメージ、表スペース・バックアップ・イメージ、増分/差分バックアップ・イメージ) で構成されます。最新のリストア・セットに属する項目が不要な場合は、PRUNE HISTORY コマンドで WITH FORCE OPTION を指定することによって、これらの項目を削除できます。

パーティション環境では、 PRUNE HISTORY コマンドは、発行されたデータベース・パーティションでのみ実行されます。複数のパーティションに関して履歴を整理するには、PRUNE HISTORY コマンドをそれぞれ個々のデータベース・パーティションから発行するか、または db2_all 接頭部を使用して PRUNE HISTORY コマンドをすべてのデータベース・パーティションに対して実行します。

重要: PRUNE LOGFILE コマンドは非推奨になっており、将来のリリースで削除される可能性があります。代わりに PRUNE HISTORY コマンドを使用してください。

許可

以下の権限のいずれか。

SYSADM
SYSCTRL
SYSMAINT
DBADM

必要な接続

データベース

コマンド構文

コマンド・パラメーター

HISTORY timestamp

削除される、リカバリー履歴ファイルにある項目範囲を識別します。完全なタイム・スタンプ (書式 yyyymmddhhmmss)、または最初の接頭部 (最小値 yyyy) を指定できます。提供されているそのタイム・スタンプ以下のタイム・スタンプ付きのすべての項目は、リカバリー履歴ファイルから削除されます。最初の接頭部を指定した場合、指定されていないタイム・スタンプの構成要素は yyyy0101000000 と解釈されます。

WITH FORCE OPTION

最新のリストア・セットのいくつかの項目がファイルから削除されるとしても、指定したタイム・スタンプに従って項目を整理することを指定します。

AND DELETE

履歴ファイルのエントリが削除されるときに、関連するログアーカイブが削除されるように指定します。この削除は、履歴ファイルのエントリーに保存されている位置情報に基づいて行われる。このオプションを使用すると、ログアーカイブが不要になったときに、アーカイブの保存領域が回復されます。ログをアーカイブするためにユーザー終了プログラムを使用している場合、このオプションを使用してログを削除することはできません。

auto_del_rec_obj データベース構成パラメータをオンに設定した場合、 AND DELETE パラメータを指定して PRUNE HISTORY を呼び出すと、履歴ファイルのエントリが削除されると、バックアップイメージとロードコピーイメージが削除されます。

注意：スナップショットバックアップのバックアップイメージは削除できません。スナップショット・バックアップのオブジェクトを削除する唯一の方法は、 db2acsutil コマンドを使用することです。

AND DELETE オプションでリカバリーオブジェクトを削除するには、履歴ファイルに対応するエントリーが見つからなければならない。以前の PRUNE コマンドが AND DELETE オプションなしで実行された場合、リカバリ・オブジェクトを削除せずに履歴エントリを削除した可能性があります。 AND DELETE オプションが設定されている後続の PRUNE コマンドは、対応する履歴レコードがもはや履歴ファイルにないため、オブジェクトを削除できない。

LOGFILE PRIOR TO log-file-name

ログ・ファイル名を表すストリング (例: S0000100.LOG) を指定します。指定したログ・ファイルより前のすべてのログ・ファイルは削除されます。指定したログ・ファイルそのものは削除されません。 logarchmeth1 データベース構成パラメーターは、OFF 以外の値に設定する必要があります。

注: この値は、 Db2® pureScale® 環境ではサポートされていません。

例

前に行われた、すべてのリストア、ロード、表スペース、バックアップ、および全部のデータベース・バックアップのための項目を除去するには、リカバリー履歴ファイルから 1994 12.1 を含んで、次のように入力してください。

db2 prune history 199412

199412 は 19941201000000 と解釈されます。

使用上の注意

WITH FORCE OPTION が使用されている場合、データベースの自動リストアに必要な項目を削除してしまう可能性があります。その場合でも手動リストアは正常に動作します。また、このコマンドを使用すると、db2ckrst ユーティリティーが、必要なバックアップ・イメージの完全なチェーンを正しく分析できなくなる可能性もあります。 WITH FORCE OPTION を指定せずに PRUNE HISTORY コマンドを使用すると、必要な項目が削除されなくなります。

状況が DB2HISTORY_STATUS_DO_NOT_DELETE の項目は整理されません。 WITH FORCE OPTION が使用されている場合、DB2HISTORY_STATUS_DO_NOT_DELETE というマークが付いたオブジェクトは、やはり整理または削除されます。 UPDATE HISTORY コマンド、UPDATE_HISTORY を指定した ADMIN_CMD、または db2HistoryUpdate API を使用して、リカバリー履歴ファイルの項目の状況を DB2HISTORY_STATUS_DO_NOT_DELETE に設定できます。 DB2HISTORY_STATUS_DO_NOT_DELETE 状況を使用して、キー・リカバリー履歴ファイルの項目が整理されないようにしたり、関連するリカバリー・オブジェクトが削除されないようにすることができます。

PRUNE HISTORY コマンドを使用してスナップショット・バックアップ・データベース履歴ファイル項目を整理することはできますが、 AND DELETE パラメーターを使用して、関連する物理リカバリー・オブジェクトを削除することはできません。スナップショット・バックアップ・オブジェクトを削除する唯一の方法は、db2acsutil コマンドを使用することです。