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 データベース構成パラメーターを ON に設定している場合、AND DELETE パラメーターを指定して PRUNE HISTORY を呼び出すと、バックアップ・イメージも物理的に削除され、その履歴ファイル項目が整理される場合にはコピー・イメージがロードされます。
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 コマンドを使用することです。