KeyValueStoreReplica.BackupAsync Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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 à
Azure SDK for .NET