7.2.5 clone

Exascaleファイルをクローニングします。

構文

clone source1 target1 [ sourceN targetN ]...
      [{ -w | --wallet } wallet-location ] 
      [{ -T | --trace } trace-level ] 
      [{ -j | --json } [ --compact ]]

コマンド・オプション

cloneコマンドのオプションは、次のとおりです:

  • source1-N: クローニングするソース・ファイルを指定します。

  • target1-N: クローンの場所を指定します。

  • -w--wallet: オプションで、Exascaleウォレット・ディレクトリへのパスを指定します。

  • -T--trace: オプションで、トレースを有効にし、トレース・レベル(trace-level)を1 (最小トレース)、2 (中程度のトレース)または3 (最大トレース)に設定します。トレース・レベルが指定されていない場合は、デフォルトで最小トレースが有効になります。

    トレース・ファイルは、次のリストの最初のアクセス可能な場所に書き込まれます:

    1. $ADR_BASE環境変数が設定されている場合:

      $ADR_BASE/diag/EXC/xsh_<user-name>/<host-name>/trace/xsh_<date>.trc
    2. /var/log/oracle/diag/EXC/xsh_<user-name>/<host-name>/trace/xsh_<date>.trc
    3. /tmp/diag/EXC/xsh_<user-name>/<host-name>/trace/xsh_<date>.trc
  • -j--json: 出力をJSON形式で表示します。

  • --compact: JSON形式の出力を、空白および改行なしのコンパクト形式で表示します。

使用上のノート

このコマンドを使用する際は、次の情報に注意してください:

  • sourceでワイルドカード(%)を使用すると、複数のソース・ファイルを指定できます。その場合は、対応するtargetにも一致するワイルドカードを含める必要があります。

  • クローン操作におけるすべてのファイルは、同じボールト内にある必要があります。

  • 複数のsourcetargetのペアを使用できます。この場合、ソース・ファイルの指定は順番に考慮され、最初の一致のみが使用されます。

  • 同じ操作で作成されるすべてのクローンは、ポイントインタイム一貫性があります。

例7-8 ファイルのクローニング

次の例では、ファイルをクローニングします。ソース・ファイルは@my-data/file1で、クローンは@my-data/clone-file1です。

$ xsh clone @my-data/file1 @my-data/clone-file1

例7-9 ファイル・グループのクローニング

次の例では、ワイルドカードを使用したファイル・グループをクローニングします。この例では、@my-data/file1@my-data/file2などの名前のファイルが存在する場合、@my-data/clone-dir/file1という名前の@my-data/file1のクローン、@my-data/clone-dir/file2という名前の@my-data/file2のクローンなどが作成されます。

$ xsh clone @my-data/file* @my-data/clone-dir/file*

例7-10 複数のファイル・グループのクローニング

次の例では、複数のファイル・グループをクローニングします。この例では、@my-data/a*および@my-data/b*をクローニングし、結果のクローンは@my-data/clone/に配置されます。

$ xsh clone @my-data/a* @my-data/clone/a* @my-data/b* @my-data/clone/b*

例7-11 順序の重要性

次の各例では、sourcetargetのペアが指定される順序の重要性を示します。

最初のコマンドでは、@my-data/a*に一致するファイルのクローンは@my-data/clone/aに作成され、その他のファイルのクローンは@my-data/clone/otherに作成されます。

$ xsh clone @my-data/a* @my-data/clone/a/a* @my-data/* @my-data/clone/other/*

次のコマンドでは、すべてのファイルが@my-data/*と一致するため、クローンはすべて@my-data/clone/otherに作成されます。この場合、2番目のsourcetargetのペアは使用されません。

$ xsh clone @my-data/* @my-data/clone/other/* @my-data/a* @my-data/clone/a/a*

例7-12 無効なコマンド

次の各例では、無効なコマンドを示します。複数のボールトが参照されるため、最初と2番目のコマンドは無効です。クローン宛先にソース指定に一致するワイルドカードが含まれていないため、最後のコマンドは無効です。

$ xsh clone @my-data/a* @my-data-backup/a*
$ xsh clone @my-data/a* @my-data/clone/a* @vault2/a* @vault2/clone/a*
$ xsh clone @my-data/withwc* @my-data/clone/withoutwc