Freigeben über


KeyValueStoreReplica.BackupAsync Methode

Definition

Ü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: