RESTORE DATABASE コマンド

Db2® バックアップ・ユーティリティーを使用してバックアップされたデータベースをリストアします。リストアされたデータベースは、バックアップ・コピーが行われた時と同じ状態になります。 RESTORE DATABASE コマンドを使用して、既存のデータベースを暗号化することもできます。

このユーティリティーは、以下のサービスも実行できます。

データベースに別のイメージを上書きしたり、バックアップ・コピーを新しいデータベースにリストアしたりします。
Db2 バージョン 9.7、 10.1、または 10.5で作成された Db2 バージョン 11.1 のバックアップ・イメージをリストアします。
- データベース・アップグレードが必要な場合、これはリストア操作の終了時に自動的に起動されます。
バックアップ操作の時点でデータベースのロールフォワード・リカバリーが有効になっていた場合は、リストア操作が正常に完了した後に、ロールフォワード・ユーティリティーを開始することによって、データベースを元の状態に戻すことができます。
表スペース・レベルのバックアップをリストアします。
TRANSPORT オプション ( Db2 バージョン 9.7 フィックスパック 2 以降) を使用して、データベース・バックアップ・イメージからデータベースに表スペース、ストレージ・グループ、および SQL スキーマのセットを転送します。 TRANSPORT オプションは、同じ名前を共用する索引と制約 (存在する場合) が定義されている表を持つ表スペースを転送することはできません。 TRANSPORT オプションは、 Db2 pureScale® 環境、またはパーティション・データベース環境ではサポートされていません。
このコマンドの発行時にそのデータベース名が存在している場合には、バックアップ・イメージが作成された時点のとおりに、すべてのストレージ・グループを置換して再定義します (ユーザーが別のリダイレクトを指定していない限り)。

異なるオペレーティング・システムおよびハードウェア・プラットフォーム間で Db2 データベース・システムによってサポートされるリストア操作について詳しくは、関連概念の異なるオペレーティング・システムおよびハードウェア・プラットフォーム間でのバックアップおよびリストア操作を参照してください。セクション。

オペレーティング・システムまたはワード・サイズ (32 ビットまたは 64 ビット) に違いがある場合、増分イメージと、前のキャプチャー ( 差分イメージと呼ばれる) の時点以降の差分のみをキャプチャーするイメージはリストアできません。

ある環境から別の環境へのリストア操作を行った後は、非増分バックアップが実施されるまで、増分バックアップまたは差分バックアップを実行できません。 (同じ環境でのリストア環境の場合、この制限はありません。)

ある環境から別の環境へのリストア操作が成功した場合でも、いくつかの注意事項があります。パッケージは、使用する前に再バインドする必要があります (BIND コマンド、REBIND コマンド、または db2rbind ユーティリティーを使用)。 SQL プロシージャーは、ドロップしてから再作成する必要があります。また、外部ライブラリーは、新しいプラットフォーム上ですべて再ビルドする必要があります。 (同じ環境にリストアする場合、これらの点は該当しません。)

既存のデータベースと既存のコンテナーに対して実行されるリストア操作では、同じコンテナーと表スペース・マップが再利用されます。

新規のデータベースに対して実行されるリストア操作では、すべてのコンテナーが再取得され、最適化された表スペース・マップが再作成されます。既存のデータベースに対して実行されるリストア操作でも 1 つ以上のコンテナーがない場合は、すべてのコンテナーが再取得され、最適化された表スペース・マップが再作成されます。

スコープ

このコマンドは、それが実行されたノードに対してだけ影響を与えます。

オンラインで SYSCATSPACE をリストアすることはできません。

許可

既存のデータベースにリストアするには、次の権限のいずれかが必要です。

SYSADM
SYSCTRL
SYSMAINT

新規のデータベースにリストアするには、次の権限のいずれかが必要です。

SYSADM
SYSCTRL

ユーザー名を指定する場合、このユーザーにはデータベースに対する CONNECT 権限が必要です。

必要な接続

必要な接続は、リストア・アクションの種類によって異なります。

既存のデータベースにリストアするには、データベース接続が必要です。このコマンドは、指定されたデータベースへの排他接続を自動的に確立します。
新しいデータベースにリストアするには、インスタンスおよびデータベース接続が必要です。データベースを作成するには、インスタンス接続が必要です。
現行のインスタンスとは異なるインスタンスで新規のデータベースへのリストアを行うには、まず、新規のデータベースを存在させるインスタンスにアタッチすることが必要です。新規インスタンスは、ローカルでもリモートでもかまいません。現行インスタンスは、DB2INSTANCE 環境変数の値に定義されます。
スナップショット・リストアの場合、インスタンス とデータベース の接続が必要です。

コマンド構文

Restore-options

Rebuild-tablespace-clause

Open-sessions

Options

Encryption Options

Master Key Options

コマンド・パラメーター

DATABASE source-database-alias

バックアップが取得されるソース・データベースの別名です。

CONTINUE

コンテナーが再定義されていること、およびリダイレクトしたリストア操作の最終ステップを実行する必要があることを指定します。

ABORT

このパラメーターは以下を指定します。

リダイレクトしたリストア操作を停止します。これは、1 つ以上のステップを繰り返す必要があるエラーが発生したときに便利です。 ABORT オプションを指定して RESTORE DATABASE を発行した後、リダイレクト・リストア操作の各ステップ ( REDIRECT オプションを指定した RESTORE DATABASE を含む) を繰り返す必要があります。
完了する前に増分リストア操作を終了します。

USER username

データベースへの接続を試みるときに使用するユーザー名を指定します。

USING password

ユーザー名を認証するために使用するパスワード。パスワードを省略すると、ユーザーに入力を求めるプロンプトが出ます。

REBUILD WITH ALL TABLE SPACES IN DATABASE

イメージをリストアする時点でデータベースが認識しているすべての表スペースを使って、データベースをリストアします。データベースが既に存在する場合、このリストアによってそれが上書きされます。

REBUILD WITH ALL TABLE SPACES IN DATABASE EXCEPT rebuild-tablespace-clause

イメージをリストアする時点でデータベースが認識しているすべての表スペースを使って、データベースをリストアします。ただし、リストで指定されているものは除外されます。データベースが既に存在する場合、このリストアによってそれが上書きされます。

REBUILD WITH ALL TABLE SPACES IN IMAGE

リストアされるイメージに含まれる表スペースだけを使ってデータベースをリストアします。データベースが既に存在する場合、このリストアによってそれが上書きされます。

REBUILD WITH ALL TABLE SPACES IN IMAGE EXCEPT rebuild-tablespace-clause

リストアされるイメージに含まれる表スペースだけを使ってデータベースをリストアします。ただし、リストで指定されているものは除外されます。データベースが既に存在する場合、このリストアによってそれが上書きされます。

REBUILD WITH rebuild-tablespace-clause

指定された表スペースのリストだけを使ってデータベースをリストアします。データベースが既に存在する場合、このリストアによってそれが上書きされます。

TABLE SPACE tablespace-name

リストアされる表スペースを指定するときに使用する名前のリストです。

TRANSPORTオプションが指定された場合、表スペース名は必須です。このオプションでは、完全リストア操作と同じほど時間がかかる可能性があります。

SCHEMA schema-name

リストアされるスキーマを指定するために使用される名前のリスト。

TRANSPORTオプションが指定された場合、スキーマ名は必須です。 SCHEMA オプションは、TRANSPORT オプションが指定された場合にのみ有効です。

ONLINE

このキーワードは、表スペース・レベルのリストア操作を行う場合のみ適用でき、これを指定するとオンラインでバックアップ・イメージがリストアできます。これは、他のエージェントが、バックアップ・イメージのリストア中にデータベースに接続できることや、指定された表スペースのリストア中に他の表スペースのデータを使用できることを意味します。

HISTORY FILE

このキーワードは、バックアップ・イメージから履歴ファイルのみをリストアする場合に指定します。

COMPRESSION LIBRARY

このキーワードは、バックアップ・イメージから圧縮ライブラリーだけをリストアする場合に指定します。バックアップ・イメージの中にオブジェクトが存在している場合、それはデータベース・ディレクトリーの中にリストアされます。バックアップ・イメージの中にオブジェクトが存在しない場合、リストア操作は失敗します。

LOGS

このキーワードは、バックアップ・イメージに含まれている一連のログ・ファイルだけをリストアする場合に指定します。バックアップ・イメージの中にログ・ファイルが含まれていない場合、リストア操作は失敗します。このオプションが指定された場合、LOGTARGET オプションも指定しなければなりません。このオプションでは、完全リストア操作と同じほど時間がかかる可能性があります。

INCREMENTAL

追加のパラメーターを指定しない場合、 INCREMENTAL パラメーターは手動累積リストア操作を指定します。手動リストア時には、リストアに関係するイメージごとに、各リストア・コマンドを手動で発行する必要があります。まず、コンテナー情報を抽出するために最後のイメージをリストアしてから、最初、2 番目、3 番目という順序で最後のイメージまで続行する必要があります。これには、最後のイメージが含まれます。詳しくは、増分バックアップからのリストアを参照してください。

INCREMENTAL AUTOMATIC/AUTO

自動累積リストア操作を指定します。

INCREMENTAL ABORT

手動累積リストア操作を指定します。

USE

TSM

Tivoli® Storage Manager (TSM) をターゲット・デバイスとして使用してデータベースをリストアすることを指定します。

XBSA

XBSA インターフェースを使用するように指定します。バックアップ・サービス API (XBSA) は、バックアップやアーカイブの目的でデータ・ストレージ管理を必要とするアプリケーションまたは機能のための、オープン・アプリケーション・プログラミング・インターフェースです。

SNAPSHOT

データがスナップショット・バックアップからリストアされるように指定します。

SNAPSHOT パラメーターは、以下のパラメーターと一緒に使用することはできません。

TABLESPACE
INCREMENTAL
TO
ON
DBPATH ON
INTO
NEWLOGPATH
WITH num-buffers BUFFERS
BUFFER
REDIRECT
REPLACE HISTORY FILE
COMPRESSION LIBRARY
PARALLELISM
COMPRLIB
OPEN num-sessions SESSIONS
HISTORY FILE
LOGS

また、REBUILD WITHオプションを含む表スペース・リストを含む復元操作では、SNAPSHOTパラメーターを使用できません。

スナップショット・バックアップ・イメージからデータをリストアするときのデフォルト動作は、すべてのコンテナー、ローカル・ボリューム・ディレクトリー、およびデータベース・パス (DBPATH) を含む、データベースを構成するすべてのパスの完全データベース・オフライン・リストアです。 LOGTARGET INCLUDE パラメーターを指定しない限り、ログはスナップショット・リストアから除外されます。 LOGTARGET EXCLUDE パラメーターは、すべてのスナップショット・リストアのデフォルトです。タイム・スタンプを指定すると、そのタイム・スタンプの付いたスナップショット・バックアップ・イメージがリストアに使用されます。

LIBRARY library-name

IBM® Data Server には、以下のストレージ・ハードウェア用の Db2 ACS API ドライバーが組み込まれています。

IBM TotalStorage SAN Volume Controller
IBM Enterprise Storage Server ® モデル 800
IBM Storwize ® V7000
IBM System Storage ® DS6000™
IBM System Storage DS8000®
IBM System Storage N シリーズ
IBM XIV®

他のストレージ・ハードウェアを使用していて、そのストレージ・ハードウェア用の Db2 ACS API ドライバーがある場合、LIBRARY パラメーターを使用してその Db2 ACS API ドライバーを指定できます。

LIBRARY パラメーターの値は、完全修飾ライブラリー・ファイル名です。

SCRIPT script-name

スナップショット・リストア操作を実行できる実行可能スクリプトの名前。スクリプト名は完全修飾ファイル名でなければなりません。

OPTIONS

「options-string」: リストア操作で使用するオプションを指定します。ストリングは、二重引用符なしで、入力されたとおりに渡されます。
@file-name: リストア操作に使用するオプションが、 Db2 サーバーにあるファイルに含まれていることを指定します。このストリングは、ベンダー・サポートのライブラリーに渡されます。ファイル名は完全修飾ファイル名でなければなりません。

VENDOROPTデータベース構成パラメーターを使用して、スナップショット復元操作のベンダー固有のオプションを指定できません。代わりに、復元ユーティリティーのOPTIONSパラメーターを使わなければなりません。

OPEN num-sessions SESSIONS

TSM またはベンダー製品とともに使用する入出力セッションの数を指定します。

FROM directory/pipename/device/remote-storage

バックアップ画像が存在するディレクトリ、名前付きパイプ、またはデバイスの完全修飾パス名。名前付きパイプからのバックアップ画像の復元は、UNIX、Linux プラットフォームにのみサポートされます。

USE TSM、 FROM、LOAD を省略した場合のデフォルト値は、クライアント・マシンの現行作業ディレクトリーです。このターゲット・ディレクトリーまたは装置は、ターゲット・サーバー/インスタンス上に存在している必要があります。

IBM Cloud Object Storage や Amazon Simple Storage Service (S3) などのリモート・ストレージ上のファイルからリストアするには、ストレージ・アクセス別名を使用してリモート・ストレージ・ロケーションを指定できます。リモート・ストレージ・サーバーから転送されるバックアップ・イメージを一時的に保管するには、ローカル・ステージング・スペースが必要です。リモート・ストレージ要件を参照してください。リモート・ストレージを指定する構文は、次のとおりです。


DB2REMOTE://<alias>//<storage-path>/<file-name>

複数の項目が指定され、項目の最後がテープ装置である場合には、他のテープが要求されます。有効な応答オプションは、次のとおりです。

c: 継続します。警告メッセージを生成した装置を使用し続けます (例えば、新しいテープがマウントされた場合)。
d: 装置の終了。警告メッセージの原因となった装置の使用だけを停止します (例えば、もうテープがない場合に停止する、など)。
t: 終了します。ユーザーが、ユーティリティーによって要求された何らかのアクションを実行しなかった場合、リストア操作を異常終了します。

LOAD shared-library

使用するベンダー・バックアップおよびリストア入出力関数を含む共有ライブラリー (Windows オペレーティング・システム上の DLL) の名前。名前には絶対パスを含めることができます。絶対パスを指定しない場合、ユーザー出口プログラムが置かれているパスがデフォルト値として使われます。

TAKEN AT date-time

データベース・バックアップ・イメージのタイム・スタンプです。タイム・スタンプはバックアップ操作が正常に終了した後に表示され、バックアップ・イメージのパス名の一部になっています。 yyyymmddhhmmss の形式で指定されます。タイム・スタンプを部分的に指定することもできます。例えば、2 つの異なるタイム・スタンプ 20021001010101 および 20021002010101 で指定されるバックアップ・イメージが存在する場合、 20021002 を指定することで、タイム・スタンプ 20021002010101 のイメージが使用できます。このパラメーターに値を指定しない場合は、ソース・メディア上のバックアップ・イメージは 1 つだけでなければなりません。

TO target-directory

このパラメーターは、ターゲット・データベース・ディレクトリーを指定します。ユーティリティーが存在するデータベースへリストアしている場合には、このパラメーターは無視されます。指定するドライブおよびディレクトリーは、ローカルのものでなければなりません。自動ストレージが有効になったデータベースがバックアップ・イメージに含まれる場合、データベース・ディレクトリーだけが変更されます。データベースに関連付けられているストレージ・パスは変更されません。

DBPATH ON target-directory

このパラメーターは、ターゲット・データベース・ディレクトリーを指定します。ユーティリティーが存在するデータベースへリストアしている場合には、このパラメーターは無視されます。指定するドライブおよびディレクトリーは、ローカルのものでなければなりません。バックアップ画像に自動ストレージが有効になっているデータベースが含まれていて、 ONパラメータが指定されていない場合、このTOパラメータはパラメータと同義であり、データベースディレクトリのみが変更されます。データベースに関連付けられているストレージ・パスは変更されません。指定パスにインスタンス名、データベースパーティション番号またはログストリームIDを取り組めないでください。 Db2 は、指定パスにこられを自動的に追加します。たとえば、指定したパスが「/ home / dbuser」の場合、Db2が必要なサブディレクトリーを追加した後の最終パスは「/ home / dbuser / prod / NODE0000 /LOGSTREAM0000/」になります。

ON path-list

このパラメーターは、データベースに関連付けられているストレージ・パスを再定義します。データベースに複数のストレージ・グループが含まれている場合、このオプションは、定義された各ストレージ・グループがその新しいストレージ・グループ・パスとして path-list を使用するように、すべてのストレージ・グループを指定のパスにリダイレクトします。ストレージ・グループが定義されていないデータベースや、自動ストレージが有効になっていないデータベースに対してこのパラメーターを使用した場合、エラー (SQL20321N) が発生します。バックアップ・イメージ内に定義された既存のストレージ・パスはもはや使用されなくなり、自動ストレージ表スペースは新しいパスに自動的にリダイレクトされます。このパラメーターが自動ストレージデータベースに指定されない場合、ストレージパスはバックアップ画像に定義されたままになります。このパラメーターを指定しない場合、パスは一般に変更されませんが、パス上のデータおよびコンテナーがリストア中に再平衡化される可能性はあります。リバランスの条件については、自動ストレージ・データベースのリストア時のリバランスを参照してください。

1 つのパス、またはコンマで区切った複数のパスを指定できます。それぞれのパスは絶対パス名でなければならず、ローカルに存在しなければなりません。

このオプションを REDIRECT オプションと一緒に指定した場合、最初の RESTORE ... REDIRECT コマンドが呼び出し元に戻るまでこのオプションは有効です。ただし、SET STOGROUP PATHS ステートメントまたは SET TABLESPACE CONTAINERS ステートメントが発行されると無効になります。その後、ストレージ・グループ・パスをリダイレクトした場合には、そうした変更によって、最初の RESTORE ... ON path-list コマンドに指定したパスはオーバーライドされます。

リストア操作中に再定義されたパスを持つストレージ・グループについては、それ以降のロールフォワード操作においてストレージ・パス関連の操作が再生されることはありません。

データベースがディスクにまだ存在せず、DBPATH ON パラメーターが指定されていない場合には、最初のパスがターゲット・データベース・ディレクトリーとして使用されます。指定パスにインスタンス名、データベースパーティション番号またはログストリームIDを取り組めないでください。 Db2 は、指定パスにこられを自動的に追加します。たとえば、指定したパスが「/ home / dbuser」の場合、Db2が必要なサブディレクトリーを追加した後の最終パスは「/ home / dbuser / prod / NODE0000 /LOGSTREAM0000/」になります。

複数パーティション・データベースの場合、ON path-list オプションはカタログ・パーティションでのみ指定できます。 ON オプションを使用する場合、カタログ・パーティションは、他のどのパーティションがリストアされるよりも前にリストアする必要があります。新しいストレージ・パスでカタログ・パーティションをリストアすると、非カタログ・データベース・パーティションのすべてが RESTORE_PENDING 状態になります。これにより、 RESTORE コマンドに ON 節を指定せずに、非カタログ・データベース・パーティションを並行してリストアすることができます。

一般に、複数パーティション・データベース内の各パーティションには同じストレージ・パスを使用する必要があり、 RESTORE DATABASE コマンドを実行する前にすべてのストレージ・パスが存在している必要があります。その例外の 1 つとして、ストレージ・パス内でデータベース・パーティション式を使用する場合があります。その使用によって、処理結果のパス名が各パーティションごとに異なるように、データベース・パーティション番号をストレージ・パスにおいて反映することができます。

RESTORE コマンドに ON 節を指定して使用すると、リダイレクト・リストア操作と同じ意味になります。

HADR 環境では、自動ストレージが有効になっている複数のストレージ・パスに対して 1 次データベースが定義されている場合、リストア中のリバランスを防止することが重要です。これを行うには、 RESTORE DATABASE コマンドの ON path-list オプションを使用し、1 次データベースと同じ順序で同じストレージ・パスのセットを指定します (この順序は、 db2pd -db dbname -storagepaths コマンドを使用して見つけることができます)。 ON path-list オプションの目的は、スタンバイ・データベースが別のストレージ・パスのセットを使用しないようにすることで、リバランスを回避することです。

ONパラメーターを使用して、スキーマ・トランスポートのストレージ・パスを再定義できません。スキーマ転送は、ターゲット・データベースの既存のストレージ・パスを使用します。

INTO target-database-alias

ターゲット・データベースの別名です。ターゲット・データベースが存在しない場合には、作成されます。

データベース・バックアップを既存のデータベースにリストアするとき、リストアされたデータベースは既存のデータベースの別名およびデータベース名を継承します。データベース・バックアップを存在していないデータベースにリストアするとき、新規のデータベースが指定した別名およびデータベース名を使用して作成されます。新しいデータベース名は、リストア先のシステムで固有のものでなければなりません。

TRANSPORT INTO target-database-alias

転送操作で使用する既存のターゲット・データベース別名を指定します。転送される表スペースとスキーマがデータベースに追加されます。

TABLESPACEとSCHEMAオプションは、有効なトランスポータブル・セットを定義する表スペース名とスキーマ名を指定しなければなりません。そうしないと、トランスポート操作が失敗します。 SQLCODE=SQL2590N rc=1.

システム・カタログは転送できません。 SQLCODE=SQL2590N rc=4.

RESTORE コマンドによってスキーマの妥当性検査が行われた後、転送される表スペース内のオブジェクトを表すシステム・カタログ項目が、ターゲット・データベースに作成されます。スキーマ再作成の完了後、ターゲット・データベースは物理表スペース・コンテナーの所有権を得ます。

リストアされる表スペースに含まれる物理オブジェクトと論理オブジェクトがターゲット・データベースに再作成され、表スペースの定義とコンテナーがターゲット・データベースに追加されます。オブジェクト作成時に障害が発生した場合、または DDL の再生が発生した場合は、エラーが返されます。

STAGE IN staging-database

転送操作のソースであるバックアップ・イメージのための一時ステージング・データベースの名前を指定します。 STAGE IN オプションが指定された場合、転送操作の完了後に一時データベースはドロップされません。このデータベースは、転送が完了したら必要ではなくなるので、DBA がドロップできます。

STAGE IN オプションを指定しない場合は、以下のようになります。

データベース名は、SYSTGxxx の形式になります (xxx は整数値)。
転送操作完了後、一時ステージング・データベースはドロップされます。

USING STOGROUP storagegroup-name

自動ストレージ表スペースの場合、すべての表スペースに関連付けられるターゲット・ストレージ・グループが転送されることを指定します。ストレージ・グループが指定されない場合には、ターゲット・データベースの、現在指定されているデフォルトのストレージ・グループが使用されます。この節は自動ストレージ表スペースのみに適用され、スキーマの transport 操作中のみ有効です。

表スペース・データが格納されるストレージ・グループを指定します。 storagegroup-name は、TRANSPORT 操作のtarget-database-aliasのストレージ・グループを示すものでなければなりません。 (SQLSTATE 42704)。これは、1 部構成の名前です。

LOGTARGET directory

スナップショット以外のリストアの場合:

バックアップ・イメージからログ・ファイルを抽出する際のターゲット・ディレクトリーとして使用する、データベース・サーバー上の既存のディレクトリーの絶対パス名。このオプションを指定する場合、バックアップ・イメージ内のログ・ファイルは、そのターゲット・ディレクトリー内に抽出されます。このオプションを指定しない場合、バックアップ・イメージ内のログ・ファイルは抽出されません。バックアップ・イメージからログ・ファイルだけを抽出する場合は、 LOGS オプションを指定してください。このオプションは、データベース・パーティション番号とログ・ストリーム ID を自動的にパスに付加します。

DEFAULT: ログ・ファイルをバックアップ・イメージからデータベースのデフォルトのログ・ディレクトリー (/home/db2user/db2inst/NODE0000/SQL00001/LOGSTREAM0000 など) にリストアします。

スナップショット・リストアの場合:

INCLUDE: スナップショット・イメージからログ・ディレクトリー・ボリュームをリストアします。このオプションが指定されていて、バックアップ・イメージにログ・ディレクトリーが含まれている場合、それらはリストアされます。ディスク上に既存のログ・ディレクトリーとログ・ファイルは、バックアップ・イメージ中のログ・ディレクトリーと競合するのでなければ、変更なしでそのままになります。ディスク上に既存のログ・ディレクトリーがバックアップ・イメージ中のログ・ディレクトリーと競合する場合は、エラーが戻されます。
EXCLUDE: ログ・ディレクトリー・ボリュームをリストアしません。このオプションを指定すると、バックアップ・イメージからログ・ディレクトリーはリストアされません。ディスク上に既存のログ・ディレクトリーとログ・ファイルは、バックアップ・イメージ中のログ・ディレクトリーと競合するのでなければ、変更なしでそのままになります。データベースに属する 1 つのパスがリストアされ、そのために暗黙のうちに 1 つのログ・ディレクトリーがリストアされ、その結果、ログ・ディレクトリーが上書きされることになる場合、エラーが戻されます。
FORCE: スナップショット・イメージをリストアする時に現行データベースの既存のログ・ディレクトリーを上書きおよび置換することを許可します。このオプションを使用しなければ、スナップショット・イメージのログ・ディレクトリーと矛盾するディスク上の既存のログ・ディレクトリーおよびログ・ファイルが原因で、リストアは失敗します。このオプションを使用して、リストアでこれらの既存のログ・ディレクトリーを上書きおよび置換できるように指示します。
注: このオプションは注意して使用してください。また、リカバリーに必要となる可能性のあるすべてのログを必ずバックアップおよびアーカイブしてください。

スナップショット・リストアの場合、ディレクトリー・オプションのデフォルト値は LOGTARGET EXCLUDEです。

NEWLOGPATH directory

リストア操作後にアクティブ・ログ・ファイルに使用されるディレクトリーの絶対パス名。このパラメーターの関数は、newlogpathデータベース構成パラメーターと同じです。このパラメーターは、バックアップ・イメージのログ・パスが、リストア後の使用に適していない場合に使用することができます。例えば、パスがもはや有効でない、または別のデータベースによって使用されている、という場合などです。

注: newlogpath コマンド・パラメーターを設定すると、 logpath パラメーターの値にノード番号が自動的に付加されます。 newlogpath データベース構成パラメーターが更新される場合にも、logpath パラメーターの値にノード番号が自動的に付加されます。詳しくは、 newlogpath-データベース・ログ・パスの変更を参照してください。

DEFAULT: リストアが完了した後、データベースはデフォルトのログ・ディレクトリー /home/db2user/db2inst/NODE0000/SQL00001/LOGSTREAM0000 をロギングに使用します。

WITH num-buffers BUFFERS

使用するバッファーの数です。値を明示的に指定しない場合、Db2 データベース・システムはこのパラメーターの最適値を自動的に選択します。複数のソースが読み取られる場合や、PARALLELISM の値が増やされている場合は、パフォーマンスを向上させるために複数のバッファーを使用することができます。

BUFFER buffer-size

リストア操作に使用するバッファーのサイズ (ページ数)。値を明示的に指定しない場合、Db2 データベース・システムはこのパラメーターの最適値を自動的に選択します。このパラメーターの最小値は 8 ページです。

リストア・バッファー・サイズは、バックアップ操作中に指定したバックアップ・バッファー・サイズに正の整数を乗算したサイズでなければなりません。誤ったバッファー・サイズを指定すると、許容可能な最小のサイズで割り振られます。

REPLACE HISTORY FILE

リストア操作において、ディスク上の履歴ファイルを、バックアップ・イメージの履歴ファイルで置換することを指定します。

REPLACE EXISTING

ターゲット・データベースの別名と同じ別名を持つデータベースが既に存在している場合、このパラメーターは、リストア・ユーティリティーが既存のデータベースをリストアしたデータベースに置換するように指定します。これはリストア・ユーティリティーを起動するスクリプトで便利です。コマンド行プロセッサーは、ユーザーに既存のデータベースの削除を検証するよう求めるプロンプトを出さないためです。 WITHOUT PROMPTING パラメーターを指定する場合、 REPLACE EXISTINGを指定する必要はありませんが、この場合、通常はユーザー介入を必要とするイベントが発生すると、操作は失敗します。

REDIRECT

リダイレクトしたリストア操作を指定します。リダイレクトしたリストア操作を完了するには、このコマンドの後に 1 つ以上の SET TABLESPACE CONTAINERS コマンドまたは SET STOGROUP PATHS コマンドを続け、次に CONTINUE オプションを指定して RESTORE DATABASE コマンドを続ける必要があります。以下に例を示します。

RESTORE DB SAMPLE REDIRECT

SET STOGROUP PATHS FOR sg_hot ON '/ssd/fs1', '/ssd/fs2'
SET STOGROUP PATHS FOR sg_cold ON '/hdd/path1', '/hdd/path2'

RESTORE DB SAMPLE CONTINUE

バックアップ・イメージの作成以降にストレージ・グループが名前変更された場合には、SET STOGROUP PATHS コマンドに指定されるストレージ・グループ名は、最新の名前ではなくバックアップ・イメージからのストレージ・グループ名を参照します。

同一のリダイレクトしたリストア操作に関連したコマンドはすべて、同じウィンドウまたは CLP セッションから起動しなければなりません。

GENERATE SCRIPT script

指定されたファイル名を使用して、リダイレクト・リストア・スクリプトを作成します。スクリプト名は相対パスまたは絶対パスであり、そのスクリプトはクライアント・サイドで生成されます。クライアント・サイドでそのファイルを作成できない場合には、エラー・メッセージ (SQL9304N) が戻されます。ファイルが既に存在する場合は上書きされます。詳しくは、以下の例を参照してください。

WITHOUT ROLLING FORWARD

データベースを、正常にリストアされた後ロールフォワード・ペンディング状態にしないように指定します。

正常なリストアに続いて、データベースがロールフォワード・ペンディング状態にある場合には、データベースが使用できるようになる前に、ROLLFORWARD コマンドを起動する必要があります。

オンライン・バックアップ・イメージからのリストアでこのオプションを指定した場合、エラー SQL2537N が戻されます。

バックアップ画像が回復可能データベースのものである場合、REBUILD オプションでWITHOUT ROLLING FORWARDを指定できません。

PARALLELISM n

リストア操作中に作成されるバッファー・マニピュレーターの数を指定します。値を明示的に指定しない場合、Db2 データベース・システムはこのパラメーターの最適値を自動的に選択します。

COMPRLIB | ENCRLIB name

バックアップ・イメージを解凍または暗号化解除するために使用するライブラリーの名前を示します。以下のライブラリーへのパスは $HOME/sqllib/libです。

暗号化ライブラリー: libdb2encr.so ( Linux® または UNIX ベースのオペレーティング・システムの場合)、 libdb2encr.a ( AIX®の場合)、および db2encr.dll (Windows オペレーティング・システムの場合)
圧縮ライブラリー: libdb2compr.so ( Linux または UNIX ベースのオペレーティング・システムの場合)、 libdb2compr.a ( AIXの場合)、および db2compr.dll (Windows オペレーティング・システムの場合)
暗号化および圧縮ライブラリー: libdb2compr_encr.so ( Linux または UNIX ベースのオペレーティング・システムの場合)、 libdb2compr_encr.a ( AIXの場合)、および db2compr_encr.dll (Windows オペレーティング・システムの場合)

この名前は、サーバー上の 1 個のファイルを参照する完全修飾パスでなければなりません。このパラメーターを指定しない場合、Db2 データベース・システムはイメージ内に格納されているライブラリーの使用を試みます。バックアップ・イメージが圧縮も暗号化もされていない場合、このパラメーターの値は無視されます。指定されたライブラリーをロードできない場合、操作は失敗します。

COMPROPTS | ENCROPTS string

バイナリー・データのうち、解凍ライブラリーまたは暗号化解除ライブラリーの初期設定ルーチンに渡すブロックを記述します。 Db2 データベース・システムはこのストリングをクライアントからサーバーに直接渡します。バイト反転やコード・ページ変換の問題がある場合はライブラリーで処理されます。データ・ブロックの先頭文字が @の場合、データの残りの部分は、サーバー上で検出されたファイルの名前として Db2 データベース・システムによって解釈されます。その場合、Db2 データベース・システムはデータ・ブロックの内容をこのファイルの内容で置き換え、その新しい値を初期設定ルーチンに渡します。ストリングの最大長は 1024 バイトです。

デフォルトの Db2 ライブラリー libdb2compr_encr.so (圧縮と暗号化) または libdb2encr.so (暗号化のみ) の場合、 ENCROPTS 変数のフォーマットは以下のようになります。

Master Key Label=label-name

Master Key Label (マスター鍵ラベル) はオプションです。マスター鍵ラベルを指定しない場合、データベース・マネージャーは、バックアップ・イメージの作成に使用されたマスター鍵ラベルを鍵ストアで探します。他のライブラリーを使う場合、 ENCROPTS 変数の形式はそれらのライブラリーによって異なります。

NO ENCRYPT

暗号化データベースを新規または既存の非暗号化データベースにリストアすることを指定します。このオプションは、表スペースのリストアには使用できません。ただし、表スペースのリストアにスキーマ・トランスポートを指定し、ターゲット・データベースが暗号化されていない場合には使用できます。

ENCRYPT

リストアされるデータベースを暗号化することを指定します。暗号化の対象には、すべてのシステム表スペース、ユーザー表スペース、TEMPORARY 表スペース、および索引と、すべてのトランザクション・ログ、データが含まれます。長形式フィールド・データ、LOB、XML データを含め、これらの表スペース内のすべてのデータ・タイプが暗号化されます。既存のデータベースにリストアする場合、または表スペース・レベルのリストア操作の場合、TRANSPORT オプションを指定する場合、あるいは USE SNAPSHOT オプションを指定する場合、このオプションは指定できません。

CIPHER

データベースの暗号化に使用する暗号化アルゴリズムを指定します。 FIPS 140-2 で認定された以下のオプションのいずれかを選択できます。

AES: Advanced Encryption Standard (AES) アルゴリズム。これがデフォルトです。
3DES: Triple Data Encryption Standard (3DES) アルゴリズム。

MODE CBC: データベースの暗号化に使用する暗号化アルゴリズム・モードを指定します。 CBC (暗号化ブロック・チェーン) がデフォルト・モードです。

KEY LENGTH key-length

データベースの暗号化に使用する鍵の長さを指定します。長さは、ビット単位で指定する以下のいずれかの値にすることができます。

128: AES でのみ使用可能
168: 3DES でのみ使用可能
192: AES でのみ使用可能
256: AES でのみ使用可能

MASTER KEY LABEL

データベースの暗号化に使用する鍵を保護するために使用するマスター鍵のラベルを指定します。マスター鍵を使用する暗号化に使用される暗号化アルゴリズムは、必ず AES です。マスター鍵を Db2 データ・サーバーで自動生成する場合は、必ず 256 ビットの鍵になります。

label-name: keystore_type データベース・マネージャー構成パラメーターの値に識別されるキーストアのマスターキーをユニーク的に識別します。 label-name の最大長は 255 バイトです。

WITHOUT PROMPTING

リストア操作を無人で実行するように指定します。通常はユーザー介入を必要とするアクションでは、エラー・メッセージが戻されます。テープやディスケットなどの取り外し可能メディア装置を使用している場合、このオプションを指定していても、その装置が終わるとプロンプトが出されます。

例

以下の例で、データベース WSDB は 0 から 3 までの番号が付けられた 4 つのデータベース・パーティションすべてに定義されています。パス /dev3/backup は、すべてのデータベース・パーティションからアクセス可能です。以下のオフライン・バックアップ・イメージは、/dev3/backup から入手可能です。
```
    wsdb.0.db2inst1.DBPART000.200802241234.001
    wsdb.0.db2inst1.DBPART001.200802241234.001
    wsdb.0.db2inst1.DBPART002.200802241234.001
    wsdb.0.db2inst1.DBPART003.200802241234.001
```
最初にカタログ・パーティションを復元してから、/dev3/backupディレクトリーからWSDBデータベースの他のすべてのデータベース・パーティションを復元するには、データベース・パーティションの1つから次のコマンドを発行してください。
```
    db2_all '<<+0< db2 RESTORE DATABASE wsdb FROM /dev3/backup 
    TAKEN AT 200802241234 
      INTO wsdb REPLACE EXISTING'
    db2_all '<<+1< db2 RESTORE DATABASE wsdb FROM /dev3/backup 
    TAKEN AT 200802241234 
      INTO wsdb REPLACE EXISTING'
    db2_all '<<+2< db2 RESTORE DATABASE wsdb FROM /dev3/backup 
    TAKEN AT 200802241234 
      INTO wsdb REPLACE EXISTING'
    db2_all '<<+3< db2 RESTORE DATABASE wsdb FROM /dev3/backup 
    TAKEN AT 200802241234 
      INTO wsdb REPLACE EXISTING'
```
db2_all ユーティリティーは、指定された各データベース・パーティションへのリストア・コマンドを出します。 db2_allで復元する場合は、常にREPLACE EXISTINGまたはWITHOUT PROMPTING(あるいはその両方) を指定しなければなりません。これを指定しないと、プロンプトが表示された場合に操作がハングしたように見えます。それは、db2_all でユーザー・プロンプトがサポートされていないためです。
以下は、別名が MYDB であるデータベースの典型的なリダイレクト・リストアのシナリオです。
1. REDIRECT オプションを指定して RESTORE DATABASE コマンドを発行します。
```
   restore db mydb replace existing redirect
```
  ステップ 1 が正常終了した後でステップ 3 が完了する前に、次を発行してリストア操作を打ち切ることができる。
```
   restore db mydb abort
```
2. 再定義する必要があるコンテナーを持つ表スペースごとに、 SET TABLESPACE CONTAINERS コマンドを発行する。以下に例を示します。
```
   set tablespace containers for 5 using
      (file 'f:\ts3con1' 20000, file 'f:\ts3con2' 20000)
```
  リストアしたデータベースのコンテナーが、このステップで指定したものであることを検査するために、 LIST TABLESPACE CONTAINERS コマンドを発行する。
3. ステップ 1 および 2 が正常終了した後、次を発行する。
```
   restore db mydb continue
```
  これはリダイレクト・リストア操作の最終ステップです。
4. ステップ 3 が失敗した場合、またはリストア操作を打ち切った場合、リダイレクト・リストアはステップ 1 から再始動できる。

以下の例は、リカバリー可能データベース用の週次の増分バックアップ・ストラテジーのサンプルです。週 1 回の全データベース・バックアップ操作、1 日 1 回の非累積 (差分) バックアップ操作、および週 2 回の累積 (増分) バックアップ操作が含まれています。

   (Sun) backup db mydb use TSM
   (Mon) backup db mydb online incremental delta use TSM
   (Tue) backup db mydb online incremental delta use TSM
   (Wed) backup db mydb online incremental use TSM
   (Thu) backup db mydb online incremental delta use TSM
   (Fri) backup db mydb online incremental delta use TSM
   (Sat) backup db mydb online incremental use TSM

金曜日の午前中に作成されたイメージを自動データベース・リストアするには、次のようにします。

   restore db mydb incremental automatic use TSM taken at (Fri)

金曜日の午前中に作成されたイメージを手動データベース・リストアするには、次のようにします。

       restore db mydb incremental use TSM taken at (Fri)
       restore db mydb incremental use TSM taken at (Sun)
       restore db mydb incremental use TSM taken at (Wed)
       restore db mydb incremental use TSM taken at (Thu)
       restore db mydb incremental use TSM taken at (Fri)

リモート・サイトに移動することを意図したバックアップ・イメージを作成し、それにログを含めるには、次のようにします。
```
   backup db sample online to /dev3/backup include logs
```
このバックアップ・イメージをリストアするには、LOGTARGET パスを指定し、ROLLFORWARD でそのパスを指定します。
```
   restore db sample from /dev3/backup logtarget /dev3/logs
  rollforward db sample to end of logs and stop overflow log path ( /dev3/logs )
```
ログを含むバックアップ・イメージから、ログ・ファイルだけを取り出すには、
```
   restore db sample logs from /dev3/backup logtarget /dev3/logs
```
次の例では、データベース SAMPLE のバックアップ操作のために、同一のターゲット・ディレクトリーを 3 回指定しています。データは 3 つのターゲット・ディレクトリーに並行してバックアップされ、それら 3 つのバックアップ・イメージは拡張子 .001、 .002、および .003 が付けられて生成されます。
```
backup db sample to /dev3/backup, /dev3/backup, /dev3/backup
```
ターゲット・ディレクトリーからバックアップ・イメージをリストアするには、次を発行します。
```
restore db sample from /dev3/backup, /dev3/backup, /dev3/backup
```
USE TSM OPTIONSキーワードを使用して、復元操作に使うTSM情報を指定できます。 Windows プラットフォームでは、 -fromowner オプションを省略してください。
- 区切り文字付きストリングを指定する場合、
```
restore db sample use TSM options '"-fromnode=bar -fromowner=dmcinnis"'
```
- 完全修飾ファイル名を指定する場合、
```
restore db sample use TSM options @/u/dmcinnis/myoptions.txt
```
  ファイル myoptions.txt には、以下の情報が含まれています。 -fromnode=bar -fromowner=dmcinnis
以下に示すのは、新しいストレージ・パスによる、複数パーティション自動ストレージ対応データベースの簡単なリストアです。データベースは元々、1 つのストレージ・パス/myPath0:に作成されています。
- カタログ・パーティションで、restore db mydb on /myPath1,/myPath2 を発行します。
- すべての非カタログ・パーティションで、restore db mydb を発行します。

非自動ストレージ・データベースにおいて以下のコマンドを発行すると、そのスクリプト出力は、

restore db sample from /home/jseifert/backups taken at 20050301100417 redirect 
generate script SAMPLE_NODE0000.clp

下記のようなものになります。

-- ****************************************************************************
-- ** automatically created redirect restore script
-- ****************************************************************************
UPDATE COMMAND OPTIONS USING S ON Z ON SAMPLE_NODE0000.out V ON;
SET CLIENT ATTACH_DBPARTITIONNUM  0;
SET CLIENT CONNECT_DBPARTITIONNUM 0;
-- ****************************************************************************
-- ** initialize redirected restore
-- ****************************************************************************
RESTORE DATABASE SAMPLE
-- USER  ‘<username>'
-- USING ‘<password>'
FROM ‘/home/jseifert/backups'
TAKEN AT 20050301100417
-- DBPATH ON ‘<target-directory>'
INTO SAMPLE
-- NEWLOGPATH ‘/home/jseifert/jseifert/SAMPLE/NODE0000/LOGSTREAM0000/'
-- WITH <num-buff> BUFFERS
-- BUFFER <buffer-size>
-- REPLACE HISTORY FILE
-- REPLACE EXISTING
REDIRECT
-- PARALLELISM <n>
-- WITHOUT ROLLING FORWARD
-- WITHOUT PROMPTING
;
-- ****************************************************************************
-- ** tablespace definition
-- ****************************************************************************
-- ****************************************************************************
-- ** Tablespace name                            = SYSCATSPACE
-- **   Tablespace ID                            = 0
-- **   Tablespace Type                          = System managed space
-- **   Tablespace Content Type                  = Any data
-- **   Tablespace Page size (bytes)             = 4096
-- **   Tablespace Extent size (pages)           = 32
-- **   Using automatic storage                  = No
-- **   Total number of pages                    = 5572
-- ****************************************************************************
SET TABLESPACE CONTAINERS FOR 0
-- IGNORE ROLLFORWARD CONTAINER OPERATIONS
USING (
  PATH   ‘SQLT0000.0'
);
-- ****************************************************************************
-- ** Tablespace name                            = TEMPSPACE1
-- **   Tablespace ID                            = 1
-- **   Tablespace Type                          = System managed space
-- **   Tablespace Content Type                  = System Temporary data
-- **   Tablespace Page size (bytes)             = 4096
-- **   Tablespace Extent size (pages)           = 32
-- **   Using automatic storage                  = No
-- **   Total number of pages                    = 0
-- ****************************************************************************
SET TABLESPACE CONTAINERS FOR 1
-- IGNORE ROLLFORWARD CONTAINER OPERATIONS
USING (
  PATH   ‘SQLT0001.0'                                                           
);
-- ****************************************************************************
-- ** Tablespace name                            = USERSPACE1
-- **   Tablespace ID                            = 2
-- **   Tablespace Type                          = System managed space
-- **   Tablespace Content Type                  = Any data
-- **   Tablespace Page size (bytes)             = 4096
-- **   Tablespace Extent size (pages)           = 32
-- **   Using automatic storage                  = No
-- **   Total number of pages                    = 1
-- ****************************************************************************
SET TABLESPACE CONTAINERS FOR 2
-- IGNORE ROLLFORWARD CONTAINER OPERATIONS
USING (
  PATH   ‘SQLT0002.0'                                                            
);
-- ****************************************************************************
-- ** Tablespace name                            = DMS
-- **   Tablespace ID                            = 3
-- **   Tablespace Type                          = Database managed space
-- **   Tablespace Content Type                  = Any data
-- **   Tablespace Page size (bytes)             = 4096
-- **   Tablespace Extent size (pages)           = 32
-- **   Using automatic storage                  = No
-- **   Auto-resize enabled                      = No
-- **   Total number of pages                    = 2000
-- **   Number of usable pages                   = 1960
-- **   High water mark (pages)                  = 96
-- ****************************************************************************
SET TABLESPACE CONTAINERS FOR 3
-- IGNORE ROLLFORWARD CONTAINER OPERATIONS
USING (
  FILE   /tmp/dms1                                                    1000
, FILE   /tmp/dms2                                                    1000
);
-- ****************************************************************************
-- ** Tablespace name                            = RAW
-- **   Tablespace ID                            = 4
-- **   Tablespace Type                          = Database managed space
-- **   Tablespace Content Type                  = Any data
-- **   Tablespace Page size (bytes)             = 4096
-- **   Tablespace Extent size (pages)           = 32
-- **   Using automatic storage                  = No
-- **   Auto-resize enabled                      = No
-- **   Total number of pages                    = 2000
-- **   Number of usable pages                   = 1960
-- **   High water mark (pages)                  = 96
-- ****************************************************************************
SET TABLESPACE CONTAINERS FOR 4
-- IGNORE ROLLFORWARD CONTAINER OPERATIONS
USING (
  DEVICE ‘/dev/hdb1'                                          1000
, DEVICE ‘/dev/hdb2'                                          1000
);
-- ****************************************************************************
-- ** start redirect restore
-- ****************************************************************************
RESTORE DATABASE SAMPLE CONTINUE;
-- ****************************************************************************
-- ** end of file
-- ****************************************************************************

自動ストレージ・データベースにおいて以下のコマンドを発行すると、そのスクリプト出力は、

restore db test from /home/jseifert/backups taken at 20050304090733 redirect
generate script TEST_NODE0000.clp

下記のようなものになります。

-- ****************************************************************************
-- ** automatically created redirect restore script
-- ****************************************************************************
UPDATE COMMAND OPTIONS USING S ON Z ON TEST_NODE0000.out V ON;
SET CLIENT ATTACH_MEMBER  0;
SET CLIENT CONNECT_MEMBER 0;
-- ****************************************************************************
-- ** initialize redirected restore
-- ****************************************************************************
RESTORE DATABASE TEST
-- USER  ‘<username>'
-- USING ‘<password>'
FROM ‘/home/jseifert/backups'
TAKEN AT 20050304090733
ON ‘/home/jseifert'
-- DBPATH ON <target-directory>
INTO TEST
-- NEWLOGPATH ‘/home/jseifert/jseifert/TEST/NODE0000/LOGSTREAM0000/'
-- WITH <num-buff> BUFFERS
-- BUFFER <buffer-size>
-- REPLACE HISTORY FILE
-- REPLACE EXISTING
REDIRECT
-- PARALLELISM <n>
-- WITHOUT ROLLING FORWARD
-- WITHOUT PROMPTING
;
-- *****************************************************************************
-- ** storage group definition
-- **   Default storage group ID                 = 0
-- **   Number of storage groups                 = 3
-- *****************************************************************************
-- *****************************************************************************
-- ** Storage group name                         = SG_DEFAULT
-- **   Storage group ID                         = 0
-- **   Data tag                                 = None
-- *****************************************************************************
-- SET STOGROUP PATHS FOR SG_DEFAULT
-- ON '/hdd/path1'
-- ,  '/hdd/path2'
-- ;
-- *****************************************************************************
-- ** Storage group name                         = SG_HOT
-- **   Storage group ID                         = 1
-- **   Data tag                                 = 1
-- *****************************************************************************
-- SET STOGROUP PATHS FOR SG_HOT
-- ON '/ssd/fs1'
-- ,  '/ssd/fs2'
-- ;
-- *****************************************************************************
-- ** Storage group name                         = SG_COLD
-- **   Storage group ID                         = 2
-- **   Data tag                                 = 9
-- *****************************************************************************
-- SET STOGROUP PATHS FOR SG_COLD
-- ON '/hdd/slowpath1'
-- ;
-- ****************************************************************************
-- ** tablespace definition
-- ****************************************************************************
-- ****************************************************************************
-- ** Tablespace name                            = SYSCATSPACE
-- **   Tablespace ID                            = 0
-- **   Tablespace Type                          = Database managed space
-- **   Tablespace Content Type                  = Any data
-- **   Tablespace Page size (bytes)             = 4096
-- **   Tablespace Extent size (pages)           = 4
-- **   Using automatic storage                  = Yes
-- **   Storage group ID                         = 0
-- **   Source storage group ID                  = -1
-- **   Data tag                                 = None
-- **   Auto-resize enabled                      = Yes
-- **   Total number of pages                    = 6144
-- **   Number of usable pages                   = 6140
-- **   High water mark (pages)                  = 5968
-- ****************************************************************************
-- ****************************************************************************
-- ** Tablespace name                            = TEMPSPACE1
-- **   Tablespace ID                            = 1
-- **   Tablespace Type                          = System managed space
-- **   Tablespace Content Type                  = System Temporary data
-- **   Tablespace Page size (bytes)             = 4096
-- **   Tablespace Extent size (pages)           = 32
-- **   Using automatic storage                  = Yes
-- **   Total number of pages                    = 0
-- ****************************************************************************
-- ****************************************************************************
-- ** Tablespace name                            = USERSPACE1
-- **   Tablespace ID                            = 2
-- **   Tablespace Type                          = Database managed space
-- **   Tablespace Content Type                  = Any data
-- **   Tablespace Page size (bytes)             = 4096
-- **   Tablespace Extent size (pages)           = 32
-- **   Using automatic storage                  = Yes
-- **   Storage group ID                         = 1
-- **   Source storage group ID                  = -1
-- **   Data tag                                 = 1
-- **   Auto-resize enabled                      = Yes
-- **   Total number of pages                    = 256
-- **   Number of usable pages                   = 224
-- **   High water mark (pages)                  = 96
-- ****************************************************************************
-- ****************************************************************************
-- ** Tablespace name                            = DMS
-- **   Tablespace ID                            = 3
-- **   Tablespace Type                          = Database managed space
-- **   Tablespace Content Type                  = Any data
-- **   Tablespace Page size (bytes)             = 4096
-- **   Tablespace Extent size (pages)           = 32
-- **   Using automatic storage                  = No
-- **   Storage group ID                         = 2
-- **   Source storage group ID                  = -1
-- **   Data tag                                 = 9
-- **   Auto-resize enabled                      = No
-- **   Total number of pages                    = 2000
-- **   Number of usable pages                   = 1960
-- **   High water mark (pages)                  = 96
-- ****************************************************************************
SET TABLESPACE CONTAINERS FOR 3
-- IGNORE ROLLFORWARD CONTAINER OPERATIONS
USING (
  FILE   ‘/tmp/dms1'                                          1000
, FILE   ‘/tmp/dms2'                                          1000
);
-- ****************************************************************************
-- ** Tablespace name                            = RAW
-- **   Tablespace ID                            = 4
-- **   Tablespace Type                          = Database managed space
-- **   Tablespace Content Type                  = Any data
-- **   Tablespace Page size (bytes)             = 4096
-- **   Tablespace Extent size (pages)           = 32
-- **   Using automatic storage                  = No
-- **   Auto-resize enabled                      = No
-- **   Total number of pages                    = 2000
-- **   Number of usable pages                   = 1960
-- **   High water mark (pages)                  = 96
-- ****************************************************************************
SET TABLESPACE CONTAINERS FOR 4
-- IGNORE ROLLFORWARD CONTAINER OPERATIONS
USING (
  DEVICE ‘/dev/hdb1'                                          1000
, DEVICE ‘/dev/hdb2'                                          1000
);
-- ****************************************************************************
-- ** start redirect restore
-- ****************************************************************************
RESTORE DATABASE TEST CONTINUE;
-- ****************************************************************************
-- ** end of file
-- ****************************************************************************

SNAPSHOT オプションを使用する RESTORE DB コマンドの例を以下に示します。
ログ・ディレクトリー・ボリュームをスナップショット・イメージからリストアし、プロンプトを出しません。
```
db2 restore db sample use snapshot LOGTARGET INCLUDE without prompting
```
ログ・ディレクトリー・ボリュームをリストアせず、プロンプトを出しません。
```
db2 restore db sample use snapshot LOGTARGET EXCLUDE without prompting
```
ログ・ディレクトリー・ボリュームをリストアせず、プロンプトを出しません。 LOGTARGETが指定されない場合、デフォルトはLOGTARGET EXCLUDEです。
```
db2 restore db sample use snapshot without prompting
```
矛盾するログ・ディレクトリーが含まれるスナップショット・イメージをリストアする時に、プロンプトを出さずに現行データベースの既存のログ・ディレクトリーを上書きおよび置換することを許可します。
```
db2 restore db sample use snapshot LOGTARGET EXCLUDE FORCE without prompting
```
矛盾するログ・ディレクトリーが含まれるスナップショット・イメージをリストアする時に、プロンプトを出さずに現行データベースの既存のログ・ディレクトリーを上書きおよび置換することを許可します。
```
db2 restore db sample use snapshot LOGTARGET INCLUDE FORCE without prompting
```
TRANSPORT REDIRECT オプションを指定した RESTORE コマンドを使用したトランスポート操作の例を以下に示します。
/srcにストレージパスがあるソースデータベース（TT_SRC）バックアップ画像と、ストレージパスが/tgtにああるターゲットデータベース（TT_TGT）があるとします。
```
> RESTORE DB TT_SRC TABLESPACE (AS1) SCHEMA (KRODGER) 
     TRANSPORT INTO TT_TGT REDIRECT

SQL1277W A redirected restore operation is being performed.  Table space
configuration can now be viewed and table spaces that do not use automatic
storage can have their containers reconfigured.
DB20000I The RESTORE DATABASE command completed successfully.
```
表スペース「AS1」は、 /tgt/krodger/NODE0000/TT_TGT/T0000003/C0000000.LRGのようなコンテナー・パスに転送されます。
転送される表スペースのターゲット・ストレージ・グループを指定するには、 RESTORE コマンドの USING STOGROUP オプションを使用できます。以下の例では、表スペース TS1 および TS2 の両方が SG_COLD ストレージ・グループにリストアされます。
```
> RESTORE DB TT_SRC TABLESPACE (TS1, TS2) SCHEMA (KRODGER)
     TRANSPORT INTO TT_TGT USING STOGROUP SG_COLD
```
注: RESTORE コマンドの USING STOGROUP オプションは、トランスポート操作中にのみ有効であり、他のリストア操作中にターゲット・ストレージ・グループを指定するために使用することはできません。
ターゲットデータベースのデフォルトのストレージグループへのトランスポートを実行するために、USING STOGROUPオプションを指定する必要はありません。
```
> RESTORE  DB TT_SRC TABLESPACE (TS3) SCHEMA (KRODGER) 
     TRANSPORT INTO TT_TGT
```
TRANSPORT 操作中に RESTORE コマンドで指定するストレージ・グループ名は、ターゲット・データベースに現在定義されているものでなければなりません。バックアップ・イメージやソース・データベースに定義されていなくても構いません。
以下の例は、暗号化オプションを指定する方法を示しています。
デフォルトの暗号化オプションを使用して、CCARDS という新規の暗号化データベースにリストアします。
```
RESTORE DATABASE ccards ENCRYPT;
```
明示的に指定した暗号化オプションを使用してバックアップ・イメージを暗号化解除することにより、同じデータベースにリストアします。
```
RESTORE DATABASE ccards
  ENCRLIB 'libdb2encr.so'
  ENCROPTS 'Master key Label=mylabel.mydb.myinstance.myserver';
```
バックアップ・イメージを保護するために使用されたマスター鍵ラベルを思い出せない場合は、 SHOW MASTER KEY DETAILS 暗号化オプションを指定して RESTORE DATABASE コマンドを実行します。その出力は、 ADMIN_GET_ENCRYPTION_INFO 表関数を実行するのと同等です。データベースはリストアされません。以下に例を示します。
```
RESTORE DATABASE ccards
  ENCRLIB 'libdb2encr.so'
  ENCROPTS 'show master key details'
```
コマンドは、バックアップ・イメージの保護に使用された各マスター鍵のラベルを戻します。このコマンドは、バックアップ作成時のマスター鍵の場所に関する情報も戻します。この情報は、名前が次の形式のファイルのsqllib/db2dumpディレクトリにあります。
```
db-name.inst-type.inst-name.
  db-partition.timestamp.masterKeyDetails
```
名前付きパイプを使用すると、中間バックアップ画像を保存せずに、あるデータベースを別のデータベースに直接バックアップすることができます。
以下の例では、ソース・データベース (srcdb) をターゲット・データベース (tgtdb) にコピーします。 BACKUP コマンドと RESTORE コマンドは、どちらの順序でも入力できます。
(1 つのセッション)
```
$ db2 backup db srcdb to /<pipename> 
```
(別のセッション)
```
$ db2 restore db srcdb from /<pipename> into tgtdb
```

（破損したために）ドロップされたデータベース・パーティションを再作成するためにパラメータAT DBPARTITIONNUMーが使用される場合、このデータベース・パーティションのデータベースは復元保留状態になります。データベース・パーティションを再作成した後、このデータベース・パーティション上のデータベースをただちにリストアする必要があります。

使用上の注意

Db2 pureScale 環境では、操作に関係するすべてのバックアップ・イメージのデータベース・メンバー・トポロジー内に存在するメンバーに対して、 REBUILD オプションを使用する RESTORE 操作と、それに続くデータベース ROLLFORWARD 操作の両方を実行する必要があります。例えば、 RESTORE REBUILD 操作で 2 つのバックアップ・イメージを使用するとします。バックアップ・イメージ A にはデータベース・メンバー・トポロジー {0,1} があり、バックアップ・イメージ B にはデータベース・メンバー・トポロジー {0, 1, 2, 3} があります。この場合、RESTORE 操作とその後の ROLLFORWARD 操作はどちらも、すべてのバックアップ・イメージに存在するメンバー 0 またはメンバー 1 のいずれかで実行する必要があります。
db2 restore db name の形式の RESTORE DATABASE コマンドは、データベース・イメージを使用してフル・データベース・リストアを実行し、表スペース・イメージで検出された表スペースの表スペース・リストア操作を実行します。 db2 restore db name tablespace 形式の RESTORE DATABASE コマンドは、イメージ内で検出された表スペースの表スペース・リストアを実行します。さらに、そのようなコマンドで表スペースのリストが指定された場合、明示的にリストされるすべての表スペースがリストアされます。
オンライン・バックアップのリストア操作を実行した後、ロールフォワード・リカバリーを実行する必要があります。
OPTIONSパラメーターを使用して、プロキシー・ノードをサポートするTSM環境での復元操作を使用可能に設置できます。詳しくは、「 Tivoli Storage Manager クライアントの構成」トピックを参照してください。
バックアップ・イメージが圧縮されているなら、Db2 データベース・システムはそのことを検出し、データはリストア前に自動的に解凍されます。 db2Restore API でライブラリーが指定されている場合、データの解凍にはそれが使用されます。そうでない場合、ライブラリーがバックアップ・イメージに保管されているかどうか検査され、ライブラリーが存在する場合にはそれが使用されます。最後に、ライブラリーがバックアップ・イメージに保管されていない場合には、データを解凍できず、リストア操作が失敗します。
圧縮ライブラリをバックアップ画像から復元する場合（COMPRESSION LIBRARYオプションを指定して明示的に、または圧縮バックアップの通常の復元を実行して暗黙的に）、復元操作はバックアップが作成されたのと同じプラットフォームと操作システムで実行しなければなりません。バックアップ作成時のプラットフォームとリストア操作実行時のプラットフォームが違っていると、それらの 2 つのシステムの間のクロスプラットフォーム・リストアが Db2 データベース・システムで通常にサポートされている場合でも、リストア操作は失敗します。
バックアップした SMS 表スペースをリストアできるのは、SMS 表スペースに対してのみです。 DMS 表スペースにはリストアできませんし、その逆も不可能です。
ログ・ファイルを含むバックアップ・イメージからログ・ファイルをリストアする場合には、LOGTARGET オプションを指定する必要があります。その際、Db2 サーバー上に存在する有効な完全修飾パス名を指定する必要があります。それらの条件が満たされている場合、リストア・ユーティリティーは、イメージ内のログ・ファイルをターゲット・パスに書き込みます。ログを含まないバックアップ・イメージのリストア操作で LOGTARGET を指定した場合、表スペース・データのリストアが試行される前にエラーが戻されます。また、無効なLOGTARGETパスまたは読み取り専用パスが指定された場合も、復元操作はエラーで失敗します。
RESTORE DATABASE コマンドの発行時に LOGTARGET パスにログ・ファイルが存在する場合は、警告プロンプトがユーザーに返されます。 WITHOUT PROMPTINGが指定された場合、この警告は返されません。
LOGTARGET を指定したリストア操作において、いずれかのログ・ファイルを抽出できない場合には、リストア操作が失敗してエラーが戻されます。バックアップ・イメージから抽出されるいずれかのログ・ファイルの名前が、LOGTARGET パス内に存在するファイル名と同じである場合には、リストア操作が失敗してエラーが返されます。データベース・リストア・ユーティリティーは、LOGTARGET ディレクトリー内の既存のログ・ファイルを上書きしません。
保存されているログ・セットだけをバックアップ・イメージからリストアすることも可能です。ログ・ファイルのみをリストアすることを指示するには、 LOGTARGET パスに加えて LOGS オプションを指定します。 LOGTARGETパスなしでLOGS オプションを指定すると、エラーになります。この操作モードでログ・ファイルをリストアしようとして問題が発生した場合、そのリストア操作は即座に終了し、エラーが戻されます。
自動増分リストア操作においては、リストア操作のターゲット・イメージに含まれるログ・ファイルだけがバックアップ・イメージから取り出されます。増分リストア処理中に参照される中間イメージに含まれるログ・ファイルは、それらの中間バックアップ・イメージから抽出されません。手動の増分復元操作中は、発行される最終復元コマンドでのみLOGTARGETパスを指定しなければなりません。
表スペース・セットの増分リストアは、一度に 1 回しか実行できません。複数の異なる表スペース・セットに対して表スペースの増分リストアを並列実行することはサポートされていません。
オフラインの全データベース・バックアップおよびオフラインの増分データベース・バックアップは、より新しいデータベース・バージョンにリストアできますが、オンライン・バックアップはそれができません。複数パーティション・データベースでは、まずカタログ・パーティションを別個にリストアしてから、その後に残りのデータベース・パーティションを (並列または逐次に) リストアする必要があります。ただし、リストア操作によって実行された暗黙的なデータベース・アップグレードは、失敗する可能性があります。複数パーティション・データベースでは、1 つ以上のデータベース・パーティションでそれが失敗することがあります。この場合、RESTORE DATABASE コマンドの後にカタログ・パーティションから発行する単一の UPGRADE DATABASE コマンドを続けて、データベースを正常にアップグレードすることができます。
RESTORE DATABASE コマンドの実行中にヘルス・モニターを使用可能にすると、暗黙的なデータベース・アップグレード中に接続が試行され、 SQL1035N メッセージが表示される可能性があります。この問題を回避するには、コマンドを実行する前にヘルス・モニターを無効にしてください。
パーティション・データベース環境では、表スペースは、異なるデータベース・パーティション上で異なるストレージ・グループ関連を持つことができます。リダイレクト・リストアで表スペース・コンテナーが DMS から自動ストレージに変更されると、その表スペースはデフォルトのストレージ・グループに関連付けられます。異なるデータベース・パーティションのリダイレクト・リストアの間に新しいデフォルト・ストレージ・グループが選択された場合、表スペースのストレージ・グループの関連付けは、パーティション・データベース環境全体で不整合になります。このような場合、必要であれば、ALTER TABLESPACE ステートメントを使用して、すべてのデータベース・パーティションの表スペースで自動ストレージを使用するように変更し、リバランスを行ってください。
TRANSPORT オプションは、クライアントとデータベースのコード・ページが等しい場合にのみサポートされます。
最初に渡すパスに、最初のイメージ・シーケンスが含まれていなければなりません。指定するパスに複数のバックアップ・イメージ・シーケンスが含まれている場合は、順番に連続してリストしなければなりません。
Db2 Developer-C Edition の場合、定義されたストレージ・サイズより大きいすべての表スペースの合計サイズを持つバックアップ・データベースのリストア、または SMS 表スペースでのリストアは失敗します。

Snapshot restore

従来の (スナップショット以外の) リストアのように、スナップショット・バックアップ・イメージをリストアする時のデフォルトの動作は、ログ・ディレクトリーをリストアしない、LOGTARGET EXCLUDE です。

いずれかのログ・ディレクトリーのグループ ID がリストアする他のパスのいずれかと共有されていることが Db2 データベース・マネージャーにより検出された場合、エラーが返されます。この場合、ログ・ディレクトリーは復元の一部でなければならないため、LOGTARGET INCLUDEまたはLOGTARGET INCLUDE FORCEを指定しなければなりません。

Db2 データベース・マネージャーは、バックアップ・イメージからのパスのリストアが行われる前に既存のログ・ディレクトリー (1 次、ミラー、およびオーバーフロー) を保存するために、すべての方法を試みます。

ログ・ディレクトリーをリストアする場合、ディスク上に事前に存在するログ・ディレクトリーがバックアップ・イメージ中のログ・ディレクトリーと競合することが Db2 データベース・マネージャーによって検出されたなら、Db2 データベース・マネージャーによってエラーが報告されます。この場合、LOGTARGET INCLUDE FORCEを指定すると、このエラーは抑止され、画像からのログ・ディレクトリーが復元され、事前に存在していたものがすべて削除されます。

LOGTARGET EXCLUDEオプションが指定され、ログディレクトリパスがデータベースディレクトリにある特殊なケースがあります（たとえば、/NODExxxx/SQLxxxxx/LOGSTREAMxxxxx/）。この場合、復元によってデータベースパスとしてログディレクトリが上書きされ、その下のすべての内容が復元されます。このシナリオに該当することが Db2 データベース・マネージャーによって検出された場合、そのログ・ディレクトリー中にログ・ファイルが存在しているなら、エラーが報告されます。 LOGTARGET EXCLUDE FORCEを指定すると、このエラーは抑止され、バックアップ画像のログ・ディレクトリーによって、ディスクの競合ログ・ディレクトリーが上書きされます。

表スペースとスキーマの転送

表スペースとスキーマの完全なリストを指定する必要があります。

転送時にターゲット・データベースがアクティブでなければなりません。

オンライン・バックアップ・イメージを使用する場合、ステージング・データベースはバックアップの最後までロールフォワードされます。オフライン・バックアップ・イメージを使用する場合、ロールフォワード処理は行われません。

バックアップ画像のシステム・カタログ表スペースに構成されるステージング・データベースは、dftdbpathデータベース・パラメーターに指定されたパスに作成されます。このデータベースは、RESTORE DATABASE コマンドが完了した時点でドロップされます。ステージング・データベースは、転送される表スペース内のオブジェクトを再生成するために使用される DDL を抽出するのに必要となります。

表スペースの転送時、Db2 データベース・マネージャーはページ・サイズが一致する最初の使用可能バッファー・プールを、転送される表スペースに割り当てようとします。転送される表スペースとページ・サイズが一致するバッファー・プールがターゲット・データベースにない場合は、隠しバッファー・プールが割り当てられることがあります。隠しバッファー・プールとは、転送される表スペース用の一時的なプレースホルダーのことです。転送完了後に、転送された表スペースに割り当てられたバッファー・プールを確認することができます。 ALTER TABLESPACE コマンドを発行して、バッファー・プールを更新することができます。

データベースのロールフォワードで表スペース・スキーマ転送ログ・レコードが検出された場合、対応する転送済み表スペースはオフラインになってドロップ・ペンディング状態に変わります。これは、転送された表スペースとその内容を再作成するための転送済み表スペースの完全なログが、データベースにないためです。転送完了後にターゲット・データベースのフルバックアップを取ることができるので、その後のロールフォワードがログ・ストリーム内のスキーマ転送のポイントを通過することはありません。

移送スキーマに式ベースのキーを持つ索引が含まれる場合、データベースのバックアップ画像からターゲット・データベースに表スペースとスキーマを移送するTRANSPORTオプションはサポートされていません。

ストレージ・グループの転送

転送操作では、ターゲット・データベースに現在定義されているストレージ・グループを変更することはできません。また、転送時に新規ストレージ・グループを明示的に作成することはできません。

転送のデフォルトのターゲット・ストレージ・グループは、操作のターゲット・データベースのデフォルトのストレージ・グループです。転送操作中にリストアするすべての表スペースを、ターゲット・データベースの特定のストレージ・グループに明示的にリダイレクトすることもできます。

転送操作中、RESTORE コマンドに TRANSPORT REDIRECT オプションを使用して実行すると、自動ストレージ表スペースのデフォルトのストレージ・グループ構成は、バックアップ・イメージで設定されている構成ではなく、ターゲット・データベースのストレージ・グループおよびストレージ・グループ・パスになります。なぜなら、自動ストレージ表スペースは、ターゲット・データベースの定義に従い、既存のストレージ・グループ・パスにリストアして直接リダイレクトする必要があるからです。

Db2 native encryption

既存のデータベースにデータベース・バックアップ・イメージをリストアする場合は必ず、既存のデータベースの暗号化設定が維持されます。 ENCRYPT オプションを指定すると、RESTORE コマンドの設定が使用されないため、エラーが戻されます。

パーティション・データベース環境内の新規データベースにリストアする場合は、まず、暗号化オプションを指定してカタログ・パーティションをリストアしてください。その後は、データベースが既に存在するので、暗号化オプションを指定せずに他のパーティションをリストアできます。 db2_all コマンドを使用する場合は、最初にカタログ・パーティションをターゲットにしてください。

Db2 ネイティブ暗号化を使用して暗号化されたバックアップ・イメージは、Db2 ネイティブ暗号化が使用可能なデータベース・サーバーにリストアされなければなりません。 Db2 ネイティブ暗号化が含まれないバージョンの Db2 を使用しているサーバーにリストアする場合は、暗号化されていないバックアップ・イメージを使用する必要があります。