KeyValueStoreReplica.BackupAsync メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
オーバーロード
| BackupAsync(String, StoreBackupOption, Func<StoreBackupInfo,Task<Boolean>>) |
キー/値ストアのバックアップを非同期的に作成します。 |
| BackupAsync(String, StoreBackupOption, Func<StoreBackupInfo,Task<Boolean>>, CancellationToken) |
キー/値ストアのバックアップを非同期的に作成します。 |
BackupAsync(String, StoreBackupOption, Func<StoreBackupInfo,Task<Boolean>>)
キー/値ストアのバックアップを非同期的に作成します。
public System.Threading.Tasks.Task BackupAsync (string backupDirectory, System.Fabric.StoreBackupOption backupOption, Func<System.Fabric.StoreBackupInfo,System.Threading.Tasks.Task<bool>> postBackupAsyncFunc);member this.BackupAsync : string * System.Fabric.StoreBackupOption * Func<System.Fabric.StoreBackupInfo, System.Threading.Tasks.Task<bool>> -> System.Threading.Tasks.TaskPublic Function BackupAsync (backupDirectory As String, backupOption As StoreBackupOption, postBackupAsyncFunc As Func(Of StoreBackupInfo, Task(Of Boolean))) As Taskパラメーター
- backupDirectory
- String
バックアップが格納されるディレクトリ。 backupOption が の場合、TruncateLogsOnlyこのパラメーターは null である必要があります。 それ以外の場合、このパラメーターを null にしたり、空にしたり、空白だけを含めたりすることはできません。 UNC パスも指定できます。 ディレクトリが存在しなければ、作成されます。 存在し、空でない場合、増分バックアップは で FabricBackupDirectoryNotEmptyException失敗します。
- backupOption
- StoreBackupOption
バックアップのオプション。
- postBackupAsyncFunc
- Func<StoreBackupInfo,Task<Boolean>>
ユーザーがシステムに制御を返す前にバックアップ後のアクティビティを完了できるようにするために Service Fabric によって呼び出されるバックアップ後の非同期メソッド。 これに 対して null が渡された場合、増分バックアップは許可されません。 バックアップ後の方法で false が返された場合、増分バックアップは許可されません。
戻り値
非同期バックアップ操作を表すタスク。
例外
backupOption が でないTruncateLogsOnly場合、backupDirectory は null です。
backupDirectory が空であるか、backupOption が でないTruncateLogsOnly場合は空白だけが含まれます。backupOption が の場合TruncateLogsOnlyは backupDirectory が null ではありません。
backupOption が でIncremental、バックアップ ディレクトリにファイルまたはサブディレクトリが既に含まれている場合。
以前に開始されたバックアップが現在進行中の場合。
例
postBackupAsyncFunc の簡単な実装の例を次に示します。
private async Task<bool> SimplePostBackupHandler(StoreBackupInfo info)
{
return await CopyBackupToAzureBlobStorage(info);
}
注釈
バックアップ中にエラーが発生した場合、 postBackupAsyncFunc は呼び出されません。 また、 backupOption が の場合は TruncateLogsOnly 呼び出されません。この場合、単一のバックアップ サイクルを完了するためにユーザーからそれ以上のアクションは必要ないためです。
適用対象
BackupAsync(String, StoreBackupOption, Func<StoreBackupInfo,Task<Boolean>>, CancellationToken)
キー/値ストアのバックアップを非同期的に作成します。
public System.Threading.Tasks.Task BackupAsync (string backupDirectory, System.Fabric.StoreBackupOption backupOption, Func<System.Fabric.StoreBackupInfo,System.Threading.Tasks.Task<bool>> postBackupAsyncFunc, System.Threading.CancellationToken cancellationToken);member this.BackupAsync : string * System.Fabric.StoreBackupOption * Func<System.Fabric.StoreBackupInfo, System.Threading.Tasks.Task<bool>> * System.Threading.CancellationToken -> System.Threading.Tasks.TaskPublic Function BackupAsync (backupDirectory As String, backupOption As StoreBackupOption, postBackupAsyncFunc As Func(Of StoreBackupInfo, Task(Of Boolean)), cancellationToken As CancellationToken) As Taskパラメーター
- backupDirectory
- String
バックアップが格納されるディレクトリ。 backupOption が の場合、TruncateLogsOnlyこのパラメーターは null である必要があります。 それ以外の場合、このパラメーターを null にしたり、空にしたり、空白だけを含めたりすることはできません。 UNC パスも指定できます。 ディレクトリが存在しなければ、作成されます。 存在し、空でない場合、増分バックアップは で FabricBackupDirectoryNotEmptyException失敗します。
- backupOption
- StoreBackupOption
バックアップのオプション。
- postBackupAsyncFunc
- Func<StoreBackupInfo,Task<Boolean>>
ユーザーがシステムに制御を返す前にバックアップ後のアクティビティを完了できるようにするために Service Fabric によって呼び出されるバックアップ後の非同期メソッド。 これに 対して null が渡された場合、増分バックアップは許可されません。 バックアップ後の方法で false が返された場合、増分バックアップは許可されません。
- cancellationToken
- CancellationToken
キャンセル要求を監視するためのトークン。
戻り値
非同期バックアップ操作を表すタスク。
例外
backupOption が でないTruncateLogsOnly場合、backupDirectory は null です。
backupDirectory が空であるか、backupOption が でないTruncateLogsOnly場合は空白だけが含まれます。backupOption が の場合TruncateLogsOnlyは backupDirectory が null ではありません。
backupOption が でIncremental、バックアップ ディレクトリにファイルまたはサブディレクトリが既に含まれている場合。
以前に開始されたバックアップが現在進行中の場合。
例
postBackupAsyncFunc の簡単な実装の例を次に示します。
private async Task<bool> SimplePostBackupHandler(StoreBackupInfo info)
{
return await CopyBackupToAzureBlobStorage(info);
}
注釈
バックアップ中にエラーが発生した場合、 postBackupAsyncFunc は呼び出されません。 また、 backupOption が の場合は TruncateLogsOnly 呼び出されません。この場合、単一のバックアップ サイクルを完了するためにユーザーからそれ以上のアクションは必要ないためです。
適用対象
Azure SDK for .NET