nzrestore コマンド構文
構文
usage: nzrestore [-h|-rev] [-hc conname] [<options>]
[-v][-db database] [-dir directory list] [-dirfile dir file]
[-connector conname] [-connectorArgs "args"] [-backupset ID]
[-sourcedb dbname] [-npshost host] [-tables tablenames]
[-tablefile filename] [-sourceschema schema_name] [-droptables]
[-increment ID] [-increment NEXT] [-increment REST] [-lockdb] [-unlockdb] [-globals]
[-noUsers] [-noAcl] [-u username] [-pw password]
[-secret value] [-streams AUTO] [-streams N] [-noData] [-allincs]
[-contents] [-history] [-incrementlist] [-suspendMViews] [-disableGroom]
[-disableSecurityCheck] [-enableSecurityCheck][-disableSecurityRestore]
[-enableSecurityRestore] [-extract [file]] [-extractTo path]| 引数 | 説明 | 例 |
|---|---|---|
| -h | コマンドのヘルプを表示します。 | |
| -レヴ | コマンドのソフトウェア・リビジョンを表示します。 | |
| -hc コンネーム | 異なるコネクタ（例えば、networker、netbackup、netbackup8-64、tsm、s3）に対してconnectorArgsで使用できるすべての引数の詳細を提供します。 | nzrestore -hc networker |
| -V[エルボース］ | 冗長モードを指定します。リストアされているオブジェクトがリストされます。 | |
| -デブ データベース | 指定されたデータベースとそのすべてのオブジェクト、およびこれらのオブジェクトが参照するユーザー、グループ、権限をリストアします。 このオプションを指定する場合、-globals を指定することはできません。 詳細については、ユーザー、グループ、および権限のバックアップと復元を参照してください。 |
|
| -監督 ディレクトリリスト | ファイル・システムからリストアする場合、バックアップ・ディレクトリーのパス名を指定します。 絶対パス名 (複数可) またはバックアップの「ルート」ディレクトリーを指定できます。 例えば、バックアップの作成時にルート・ディレクトリー /usr/backups を使用した場合、そのバックアップからリストアするには /usr/backups を指定します。 バックアップを複数のファイル・システムに保存した場合は、これらすべての場所のルートをこの引数に指定します。 例えば、バックアップが /home/backup1、/home/backup2、および /home/backup3 に書き込まれている場合には、この 3 つの場所をすべて指定することで、単一の操作でデータをリストアできます。 |
|
| -ディレクトリファイル | バックアップのソース・ディレクトリーを (各行につき 1 つ) リストするファイルを指定します。 | |
| -コネクタ コンネーム | バックアップの送信先となるコネクターの名前です。 有効な値は以下のとおりです。
TSM、 NetBackup、 NetWorker,のいずれかに32ビットと64ビットの両方のクライアントがインストールされている場合、システムはデフォルトで32ビットのクライアントを使用します。 -connector オプションで名前 (tsm6-64、netbackup7-64、または networker7-64) を指定することにより、システムに 64 ビット・クライアントを使用させることができます。 64ビットクライアントのみがインストールされている場合、システムは64ビットクライアントを使用して復元を行います。 システムは、指定されたコネクター名に基づき、バックアップ・ソフトウェアを「ディスカバー」します。 複数のバージョンのバックアップ・コネクタがインストールされている場合（たとえば、Tivoli Storage Manager5とTivoli Storage Manager6）、以前の一般的な引数の代わりにこれらの値のいずれかを使用することで、特定のバージョンを使用できます：
|
|
| --connectorArgs"args" | コネクターの passthrough 引数のコロンで区切られたリストを指定します。 引数ストリングは、二重引用符で囲まれていなければなりません。 | |
| -バックアップセット 身分証明書 | デフォルトを無効にするバックアップ・セットを指定します。 | |
| -ソースドビー データベース名 | デフォルトを無効にする、データベースのバックアップ・セットを指定します。 nzrestoreコマンドは、-sourcedbオプションで別のバックアップセットを指定しない限り、-dbの最新のバックアップを復元する。 |
|
| -エヌピーエスホスト ホスト | デフォルトでは、リストアはローカルホストで作成されたバックアップセットを検索します。 nzrestore使用して、別のNetezza Performance Serverホストで作成されたデータベース、スキーマ、またはユーザー・バックアップを移行する場合は、このオプションを使用してバックアップ・セットを作成したホストを指定します。 | |
| -テーブル テーブル・リスト | table_list 引数で指定された表をリストアします。これは、スペースで区切った表のリストです。 表名には大/小文字の区別があるので、 バックアップ・セットに示されているとおりに表名を指定する必要があります。 nzrestore -contents オプションを使用して、バックアップ・セット内のオブジェクトの名前を表示できます。 | |
| -テーブルファイル ファイル名 | 表リストにリストされている表をリストアします。これは、各行に 1 表を示す表リストを含んだファイルです。 表名には大/小文字の区別があるので、 バックアップ・セットに示されているとおりに表名を指定する必要があります。 | |
| -ソーススキーマ スキーマ名 | 複数のスキーマをサポートするシステムでは、データベース・バックアップに、そのデータベース内のすべてのスキーマのすべてのオブジェクトが含まれています。 ユーザーは、異なるスキーマで同じ名前のテーブルを作成する可能性があります。 -tables または -tablefile 引数のリストア対象表を一意的に識別するために、
-sourceschema オプションを使用して、その表が定義されたバックアップ・セット内のスキーマを指定してください。 -sourceschema 引数はオプションですが、その名前を持つ複数の表がバックアップ・セット内に検出された場合には、コマンドからエラーが戻されます。 スキーマ名には大/小文字の区別があるので、 バックアップ・セットに示されているとおりにスキーマ名を指定する必要があります。 nzrestore -contents オプションを使用して、バックアップ・セット内のオブジェクトの名前を表示できます。 -tables または -tablefile 引数に表のリストを含めた場合、 -sourceschema 値はそれらの表のすべてに適用されます。 同じバックアップ・セット内のさまざまなスキーマから表をリストアする場合は、スキーマごとに別の nzrestore コマンドを使用し、それぞれに -sourceschema を指定して 1 つまたは複数の表をリストアします。 |
|
| -ドロップテーブル | 表レベルのリストア中に、表リストにリストされている表を除去してから、表をリストアします。 | |
| -インクリメント[ID｜NEXT｜REST］ | 増分 ID を指定すると、このコマンドは、ユーザー指定の増分番号まで部分リストアを実行します。 部分リストアを実行した後、バックアップ・セットから次の増分をリストアするには、NEXT を指定します。 REST を指定すると、このコマンドは、バックアップ・セットから残りの増分をリストアします。 |
|
| -ロックデータベース | データベースを読み取り専用にしてリストア中の変更を防ぎます。 「true」の意味で使用できるのは、1、t、T、y、Y、true、TRUE、yes、Yes、または YES です。 「false」の意味で使用できるのは、0、f、F、n、N、false、False、FALSE、no、No、または NO です。 このオプションを指定しない場合、データベースはロックされないままとなり、以降の増分リストア処理は不可能になります。 |
|
| -ロック解除 | 別のリストアを実行せずにデータベースのロックを解除します。 このオプションは、ターゲット・データベースがロックされたままになっている可能性があるため、リストアが中止されたり失敗したりする場合に便利です。 このオプションを使用すると、データベースのロックを解除できます。 | |
| -グローバル | ユーザー、グループ、グローバル権限、およびマルチレベルのセキュリティー情報 (カテゴリー、コホート、レベルなど) をリストアします。 詳細については、ユーザー、グループ、および権限のバックアップと復元を参照してください。 -globals を使用する場合、-db を指定することはできません。 ユーザー、グループ、およびグローバル許可の作成は非破壊的である。つまり、ユーザーまたはグループが存在する場合、システムはそれを上書きしない。 冗長モードを指定すると、nzrestore コマンドはユーザーまたはグループ作成エラーが 1 つでも発生するとメッセージを表示し、リストア・ログで詳細を確認するよう指示します。 データを新しいシステムに転送する場合は、最初に nzrestore -globals を使用してユーザー、グループ、権限、およびセキュリティー情報が存在することを確実にしてから、データをリストアしてください。 |
|
| -noUsers | ユーザーまたはグループのリストアを無効にします。 | |
| -noAcl | 権限のリストアを無効にします。 | |
| -u ユーザー名 | リストアを実行するためにデータベースに接続するユーザ名を指定します。 | |
| -pw password | ユーザーのパスワードを指定します。 | |
| -シークレット 価値 | データに含まれるホスト・キーの暗号化解除に使用する、256 ビットの対称鍵を生成するために必要なストリング値を指定します。 | |
| -ストリーム[AUTO |N］ | データベース・アーカイブをリストアするときに使用するストリームの数を指定します。 詳細については、 マルチストリーム・リストアを参照。 AUTO を指定した場合、リストアに使用するストリームの数はコマンドが選択します。 ストリームの数は通常、バックアップ・アーカイブを作成した nzbackup コマンドで使用されていたストリームの数と同じです。 -stream N オプションを使用して、コマンドのストリーム数を指定できます。 streams値を指定しないと、リストア処理ではhost.bnrRestoreStreamsDefaultレジストリ設定で定義されているストリーム数が使用されます。 |
|
| -noData | リストアされた表のデータではなく、データベース・スキーマ (オブジェクトおよびアクセス権限の定義) のみをリストアします。 | |
| -allIncs | -noData と併せて使用して、すべての増分でユーザー定義オブジェクト (関数、集約) をリストアします。 | |
| -内容 | バックアップ・アーカイブに格納された個々のデータベース・オブジェクトの名前とタイプをリストします。 ファイル・システム・バックアップの位置については、バックアップ・アーカイブの位置に -dir、 特定のデータベースに -db を指定する必要があります。 |
|
| -history | リストア履歴レポートを印刷します。 | |
| -インクリメントリスト | 使用可能なバックアップ・セットおよび増分のレポートを出力します。 connectorを指定する必要がある。 -npshost、-sourcedb、またはこの両方を指定することもできます。 |
|
| -suspendMViews | 表レベル・リストアまたは増分リストアの実行後、マテリアライズド・ビューをサスペンド状態のままにします。 | |
| -disableGroom | リストア操作終了時のバージョン付き表の自動グルーミングを無効にします。 | |
| -disableSe-curityCheck | nzrestore -db 操作の場合、このコマンドは、バックアップ・セットに含まれるすべてのセキュリティー・メタデータがターゲット・システムに存在することを確認します。 ターゲットは、バックアップ・セットに定義されているレベル、カテゴリー、およびコホートと互換性のある MLS モデルを使用している必要があります。 場合によっては、バックアップ・セットに、ターゲット・データベースには存在しない古い未使用のメタデータが含まれていることがあります。その場合、デフォルトでは nzrestore -db が失敗します。 このスイッチを使用して、メタデータ・チェックを完全にバイパスすることはできますが、ターゲット・システムには存在しないラベルを含むデータがバックアップ・セットに含まれていると、リストアは失敗し、ロールバックが行われます。 | |
| -enableSe-curityCheck | バックアップ・セットに含まれるセキュリティー・メタデータのチェックだけを行い、リストアしません。 | |
| -disableSe-curityRestore | nzrestore -globals を使用する場合、このオプションは、バックアップ・セットにセキュリティー・メタデータが含まれていても、それを無視します (リストアしません)。 | |
| -enableSe-curityRestore | nzrestore -db 操作の場合、バックアップ・セットに含まれるセキュリティー・メタデータをターゲット・システムにリストアします。 | |
| -ファイル]を取り出す | 指定されたバックアップ・セットから、指定されたファイルを抽出します。 ファイルを指定しない場合、このオプションは、バックアップ・セットに含まれるすべてのファイルをリストします。 -extract オプションが使用されている場合、リストア・コマンドは指定されたバックアップ・セットまたはファイルをリストアしません。 -extract オプションにより、コマンドはリストア操作をスキップし、要求されたファイルまたはリストを出力します。 |
|
| -extractTo パス | 抽出された出力の保存先とするファイル名またはディレクトリーを指定します。 ディレクトリーを指定しないと、-extract オプションは nzrestore コマンドが実行された現行ディレクトリーにファイルを保存します。 | |
| -forceCreateViews | ビューが存在し、定義が変更されていない場合でも、増分リストア中にビューの再作成を強制します。 |
nzrestore の環境設定
| 名前 | 対応するコマンド行パラメーター |
|---|---|
| NZ_USER | -u と同じ |
| NZ_PASSWORD | -pw と同じ |
リストア・エラー
nzrestore コマンドは、エラーを /nz/kit/log/restoresvr/restoresvr.pid.date.log ファイルに書き込みます。 ログファイルの詳細については、システムログを参照してください。