6.2.8.11 snapshotfile

スナップショットを作成します。

用途

snapshotfileコマンドは、ファイルまたはファイル・グループのスナップショットを作成します。

構文

snapshotfile source1 target1 [ sourceN targetN ]... 
             [ --exclude exclude-spec ]...

コマンド・オプション

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

• source1-N: スナップショット・ソースであるファイル(1つまたは複数)の名前を指定します。

• target1-N: スナップショット宛先であるファイル(1つまたは複数)の名前を指定します。

• --exclude: スナップショット操作から除外されるファイル(1つまたは複数)の名前を指定します。

使用上のノート

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

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

• スナップショット操作におけるすべてのファイルは同じボールト内にある必要があり、そうでない場合はエラーが返されます。

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

• --excludeオプションを使用して指定したファイルは、スナップショット操作から除外されます。このような除外は、すべてのsourceとtargetのペアに適用されます。

• NULL (空の)文字列をtarget値として指定した場合、対応するsourceのスナップショットは作成されません。NULL targetの指定は、スナップショット操作からファイルを除外する代替方法です。

  sourceとNULL targetは、他のすべてのsourceとtargetのペアとともに順番に考慮され、最初の一致のみが使用されます。

• 同じ操作で作成されるすべてのスナップショットは、ポイントインタイム一貫性があります。

例

例6-106 ファイルのスナップショットの作成

この例では、スナップショットを作成します。ソース・ファイルは@my-data/file1で、スナップショットは@my-data/snap-file1です。

@> snapshotfile @my-data/file1 @my-data/snap-file1

例6-107 ファイル・グループのスナップショットの作成

この例では、ワイルドカードを使用したファイル・グループのスナップショットを作成します。この例では、@my-data/file1、@my-data/file2などのファイルが存在する場合、@my-data/snap-dir/file1という名前の@my-data/file1のスナップショット、@my-data/snap-dir/file2という名前の@my-data/file2のスナップショットなどが作成されます。

@> snapshotfile @my-data/file* @my-data/snap-dir/file*

例6-108 複数のファイル・グループのスナップショットの作成

この例では、ワイルドカードを使用して複数のファイル・グループのスナップショットを作成します。ソース・ファイル・グループは@my-data/a*および@my-data/b*であり、結果のスナップショットは@my-data/snap/に配置されます。

@> snapshotfile @my-data/a* @my-data/snap/a* @my-data/b* @my-data/snap/b*

例6-109 順序の重要性

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

最初のコマンドでは、@my-data/a*に一致するファイルのスナップショットは@my-data/snap/aに作成され、その他のファイルのスナップショットは@my-data/snap/otherに作成されます。

@> snapshotfile @my-data/a* @my-data/snap/a/a* @my-data/* @my-data/snap/other/*

次のコマンドでは、すべてのファイルが@my-data/*と一致するため、スナップショットはすべて@my-data/snap/otherに作成されます。この場合、2番目のsourceとtargetのペアは使用されません。

@> snapshotfile @my-data/* @my-data/snap/other/* @my-data/a* @my-data/snap/a/a*

例6-110 除外を指定したファイル・グループのスナップショットの作成

次の例は、@my-data/a*または@my-data/b*と一致するファイルを除く、@my-data内のファイルのスナップショットを作成する方法を示しています。

@> snapshotfile @my-data/* @my-data/snap/* --exclude @my-data/a* --exclude @my-data/b*

@> snapshotfile @my-data/a* "" @my-data/b* "" @my-data/* @my-data/snap/*

例6-111 無効なコマンド

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

@> snapshotfile @my-data/a* @my-data-backup/a*

@> snapshotfile @my-data/a* @my-data/snap/a* @vault2/a* @vault2/snap/a*

@> snapshotfile @my-data/withwc* @my-data/snap/withoutwc