Partager via


KeyValueStoreReplica.BackupAsync Méthode

Définition

Surcharges

BackupAsync(String, StoreBackupOption, Func<StoreBackupInfo,Task<Boolean>>)

Crée de manière asynchrone une sauvegarde du magasin de clés/valeurs.

BackupAsync(String, StoreBackupOption, Func<StoreBackupInfo,Task<Boolean>>, CancellationToken)

Crée de manière asynchrone une sauvegarde du magasin de clés/valeurs.

BackupAsync(String, StoreBackupOption, Func<StoreBackupInfo,Task<Boolean>>)

Crée de manière asynchrone une sauvegarde du magasin de clés/valeurs.

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

Paramètres

backupDirectory
String

Répertoire dans lequel la sauvegarde doit être stockée. Si backupOption est TruncateLogsOnly, ce paramètre doit avoir la valeur Null. Sinon, ce paramètre ne peut pas être null, vide ou contenir uniquement des espaces blancs. Des chemins UNC peuvent également être fournis. Si le répertoire n’existe pas, il est créé. S’il existe et n’est pas vide, la sauvegarde incrémentielle échoue avec FabricBackupDirectoryNotEmptyException.

backupOption
StoreBackupOption

Options de la sauvegarde.

postBackupAsyncFunc
Func<StoreBackupInfo,Task<Boolean>>

Méthode asynchrone post-sauvegarde appelée par Service Fabric pour permettre à l’utilisateur d’effectuer une activité de post-sauvegarde avant de retourner le contrôle au système. Si null est transmis pour cela, les sauvegardes incrémentielles ne sont pas autorisées. Si la méthode post-sauvegarde retourne false, les sauvegardes incrémentielles ne sont pas autorisées.

Retours

Tâche qui représente l’opération de sauvegarde asynchrone.

Exceptions

backupDirectory a la valeur null lorsque backupOption n’est pas TruncateLogsOnly.

backupDirectory est vide ou contient uniquement des espaces blancs lorsque backupOption n’est pas TruncateLogsOnly ou backupDirectory n’est pas null lorsque backupOption est TruncateLogsOnly.

Lorsque backupOption est Incremental et que le répertoire de sauvegarde contient déjà des fichiers ou des sous-répertoires.

Lorsqu’une sauvegarde lancée précédemment est en cours.

Exemples

Voici un exemple d’implémentation simple de postBackupAsyncFunc

private async Task<bool> SimplePostBackupHandler(StoreBackupInfo info)
{
    return await CopyBackupToAzureBlobStorage(info);
}

Remarques

Le postBackupAsyncFunc n’est pas appelé en cas d’erreur lors de la sauvegarde. En outre, il n’est pas appelé lorsque backupOption est TruncateLogsOnly , car il n’y a aucune action supplémentaire nécessaire de la part de l’utilisateur dans ce cas pour effectuer un cycle de sauvegarde unique.

S’applique à

BackupAsync(String, StoreBackupOption, Func<StoreBackupInfo,Task<Boolean>>, CancellationToken)

Crée de manière asynchrone une sauvegarde du magasin de clés/valeurs.

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

Paramètres

backupDirectory
String

Répertoire dans lequel la sauvegarde doit être stockée. Si backupOption est TruncateLogsOnly, ce paramètre doit avoir la valeur Null. Sinon, ce paramètre ne peut pas être null, vide ou contenir uniquement des espaces blancs. Des chemins UNC peuvent également être fournis. Si le répertoire n’existe pas, il est créé. S’il existe et n’est pas vide, la sauvegarde incrémentielle échoue avec FabricBackupDirectoryNotEmptyException.

backupOption
StoreBackupOption

Options de la sauvegarde.

postBackupAsyncFunc
Func<StoreBackupInfo,Task<Boolean>>

Méthode asynchrone post-sauvegarde appelée par Service Fabric pour permettre à l’utilisateur d’effectuer une activité de post-sauvegarde avant de retourner le contrôle au système. Si null est transmis pour cela, les sauvegardes incrémentielles ne sont pas autorisées. Si la méthode post-sauvegarde retourne false, les sauvegardes incrémentielles ne sont pas autorisées.

cancellationToken
CancellationToken

Jeton pour surveiller les requêtes d'annulation.

Retours

Tâche qui représente l’opération de sauvegarde asynchrone.

Exceptions

backupDirectory a la valeur null lorsque backupOption n’est pas TruncateLogsOnly.

backupDirectory est vide ou contient uniquement des espaces blancs lorsque backupOption n’est pas TruncateLogsOnly ou backupDirectory n’est pas null lorsque backupOption est TruncateLogsOnly.

Lorsque backupOption est Incremental et que le répertoire de sauvegarde contient déjà des fichiers ou des sous-répertoires.

Lorsqu’une sauvegarde lancée précédemment est en cours.

Exemples

Voici un exemple d’implémentation simple de postBackupAsyncFunc

private async Task<bool> SimplePostBackupHandler(StoreBackupInfo info)
{
    return await CopyBackupToAzureBlobStorage(info);
}

Remarques

Le postBackupAsyncFunc n’est pas appelé en cas d’erreur lors de la sauvegarde. En outre, il n’est pas appelé lorsque backupOption est TruncateLogsOnly , car il n’y a aucune action supplémentaire nécessaire de la part de l’utilisateur dans ce cas pour effectuer un cycle de sauvegarde unique.

S’applique à