KeyValueStoreReplica.BackupAsync Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Überlädt
BackupAsync(String, StoreBackupOption, Func<StoreBackupInfo,Task<Boolean>>) |
Erstellt asynchron eine Sicherung des Schlüssel-Wert-Speichers. |
BackupAsync(String, StoreBackupOption, Func<StoreBackupInfo,Task<Boolean>>, CancellationToken) |
Erstellt asynchron eine Sicherung des Schlüssel-Wert-Speichers. |
BackupAsync(String, StoreBackupOption, Func<StoreBackupInfo,Task<Boolean>>)
Erstellt asynchron eine Sicherung des Schlüssel-Wert-Speichers.
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.Task
Public Function BackupAsync (backupDirectory As String, backupOption As StoreBackupOption, postBackupAsyncFunc As Func(Of StoreBackupInfo, Task(Of Boolean))) As Task
Parameter
- backupDirectory
- String
Das Verzeichnis, in dem die Sicherung gespeichert werden soll. Wenn backupOption auf festgelegt ist TruncateLogsOnly, sollte dieser Parameter NULL sein. Andernfalls kann dieser Parameter nicht NULL oder leer sein oder nur Leerzeichen enthalten. UNC-Pfade können auch bereitgestellt werden. Wenn das Verzeichnis noch nicht vorhanden ist, wird es erstellt. Wenn es vorhanden ist und nicht leer ist, schlägt die inkrementelle Sicherung mit FabricBackupDirectoryNotEmptyExceptionfehl.
- backupOption
- StoreBackupOption
Die Optionen für die Sicherung.
- postBackupAsyncFunc
- Func<StoreBackupInfo,Task<Boolean>>
Die asynchrone Methode nach der Sicherung, die von Service Fabric aufgerufen wird, damit der Benutzer alle Aktivitäten nach der Sicherung abschließen kann, bevor die Steuerung an das System zurückgegeben wird. Wenn dafür NULL übergeben wird, sind inkrementelle Sicherungen nicht zulässig. Wenn die Methode nach der Sicherung false zurückgibt, sind inkrementelle Sicherungen nicht zulässig.
Gibt zurück
Eine Aufgabe, die den asynchronen Sicherungsvorgang darstellt.
Ausnahmen
backupDirectory ist NULL , wenn backupOption nicht TruncateLogsOnlyist.
backupDirectory ist leer oder enthält nur Leerzeichen, wenn backupOption nicht TruncateLogsOnly oder backupDirectory nicht NULL ist, wenn backupOption den Wert hat TruncateLogsOnly.
Wenn backupOption ist Incremental und das Sicherungsverzeichnis bereits Dateien oder Unterverzeichnisse enthält.
Wenn eine zuvor initiierte Sicherung gerade ausgeführt wird.
Beispiele
Nachfolgend finden Sie ein Beispiel für eine einfache Implementierung von postBackupAsyncFunc.
private async Task<bool> SimplePostBackupHandler(StoreBackupInfo info)
{
return await CopyBackupToAzureBlobStorage(info);
}
Hinweise
PostBackupAsyncFunc wird nicht aufgerufen, wenn während der Sicherung ein Fehler auftritt. Außerdem wird es nicht aufgerufen, wenn backupOption ist TruncateLogsOnly , da der Benutzer in diesem Fall keine weitere Aktion benötigt, um einen einzelnen Sicherungszyklus abzuschließen.
Gilt für:
BackupAsync(String, StoreBackupOption, Func<StoreBackupInfo,Task<Boolean>>, CancellationToken)
Erstellt asynchron eine Sicherung des Schlüssel-Wert-Speichers.
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.Task
Public Function BackupAsync (backupDirectory As String, backupOption As StoreBackupOption, postBackupAsyncFunc As Func(Of StoreBackupInfo, Task(Of Boolean)), cancellationToken As CancellationToken) As Task
Parameter
- backupDirectory
- String
Das Verzeichnis, in dem die Sicherung gespeichert werden soll. Wenn backupOption auf festgelegt ist TruncateLogsOnly, sollte dieser Parameter NULL sein. Andernfalls kann dieser Parameter nicht NULL oder leer sein oder nur Leerzeichen enthalten. UNC-Pfade können auch bereitgestellt werden. Wenn das Verzeichnis noch nicht vorhanden ist, wird es erstellt. Wenn es vorhanden ist und nicht leer ist, schlägt die inkrementelle Sicherung mit FabricBackupDirectoryNotEmptyExceptionfehl.
- backupOption
- StoreBackupOption
Die Optionen für die Sicherung.
- postBackupAsyncFunc
- Func<StoreBackupInfo,Task<Boolean>>
Die asynchrone Methode nach der Sicherung, die von Service Fabric aufgerufen wird, damit der Benutzer alle Aktivitäten nach der Sicherung abschließen kann, bevor die Steuerung an das System zurückgegeben wird. Wenn dafür NULL übergeben wird, sind inkrementelle Sicherungen nicht zulässig. Wenn die Methode nach der Sicherung false zurückgibt, sind inkrementelle Sicherungen nicht zulässig.
- cancellationToken
- CancellationToken
Das Token zum Überwachen von Abbruchanforderungen.
Gibt zurück
Eine Aufgabe, die den asynchronen Sicherungsvorgang darstellt.
Ausnahmen
backupDirectory ist NULL , wenn backupOption nicht TruncateLogsOnlyist.
backupDirectory ist leer oder enthält nur Leerzeichen, wenn backupOption nicht TruncateLogsOnly oder backupDirectory nicht NULL ist, wenn backupOption den Wert hat TruncateLogsOnly.
Wenn backupOption ist Incremental und das Sicherungsverzeichnis bereits Dateien oder Unterverzeichnisse enthält.
Wenn eine zuvor initiierte Sicherung gerade ausgeführt wird.
Beispiele
Nachfolgend finden Sie ein Beispiel für eine einfache Implementierung von postBackupAsyncFunc.
private async Task<bool> SimplePostBackupHandler(StoreBackupInfo info)
{
return await CopyBackupToAzureBlobStorage(info);
}
Hinweise
PostBackupAsyncFunc wird nicht aufgerufen, wenn während der Sicherung ein Fehler auftritt. Außerdem wird es nicht aufgerufen, wenn backupOption ist TruncateLogsOnly , da der Benutzer in diesem Fall keine weitere Aktion benötigt, um einen einzelnen Sicherungszyklus abzuschließen.
Gilt für:
Azure SDK for .NET