Compartir a través de


KeyValueStoreReplica.BackupAsync Método

Definición

Sobrecargas

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

Crea de forma asincrónica una copia de seguridad del almacén de clave-valor.

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

Crea de forma asincrónica una copia de seguridad del almacén de clave-valor.

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

Crea de forma asincrónica una copia de seguridad del almacén de clave-valor.

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

Parámetros

backupDirectory
String

Directorio donde se va a almacenar la copia de seguridad. Si backupOption es TruncateLogsOnly, este parámetro debe ser NULL. De lo contrario, este parámetro no puede ser nulo, estar vacío o contener solo espacios en blanco. También se pueden proporcionar rutas UNC. Si el directorio no existe, se crea. Si existe y no está vacío, se produce un error en la copia de seguridad incremental con FabricBackupDirectoryNotEmptyException.

backupOption
StoreBackupOption

Las opciones de la copia de seguridad.

postBackupAsyncFunc
Func<StoreBackupInfo,Task<Boolean>>

Método asincrónico posterior a la copia de seguridad invocado por Service Fabric para permitir al usuario completar cualquier actividad posterior a la copia de seguridad antes de devolver el control al sistema. Si se pasa null para esto, no se permiten las copias de seguridad incrementales. Si el método posterior a la copia de seguridad devuelve false, de nuevo, no se permiten las copias de seguridad incrementales.

Devoluciones

Tarea que representa la operación de copia de seguridad asincrónica.

Excepciones

backupDirectory es null cuando backupOption no TruncateLogsOnlyes .

backupDirectory está vacío o solo contiene espacios en blanco cuando backupOption no TruncateLogsOnly es o backupDirectory no es null cuando backupOption es TruncateLogsOnly.

Cuando backupOption es Incremental y el directorio de copia de seguridad ya contiene archivos o subdirectorios.

Cuando una copia de seguridad iniciada anteriormente está en curso.

Ejemplos

A continuación se muestra un ejemplo de una implementación sencilla de postBackupAsyncFunc

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

Comentarios

PostBackupAsyncFunc no se invoca si se produce un error durante la copia de seguridad. Además, no se invoca cuando backupOption es TruncateLogsOnly porque no se necesita ninguna acción adicional del usuario en este caso para completar un único ciclo de copia de seguridad.

Se aplica a

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

Crea de forma asincrónica una copia de seguridad del almacén de clave-valor.

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

Parámetros

backupDirectory
String

Directorio donde se va a almacenar la copia de seguridad. Si backupOption es TruncateLogsOnly, este parámetro debe ser NULL. De lo contrario, este parámetro no puede ser nulo, estar vacío o contener solo espacios en blanco. También se pueden proporcionar rutas UNC. Si el directorio no existe, se crea. Si existe y no está vacío, se produce un error en la copia de seguridad incremental con FabricBackupDirectoryNotEmptyException.

backupOption
StoreBackupOption

Las opciones de la copia de seguridad.

postBackupAsyncFunc
Func<StoreBackupInfo,Task<Boolean>>

Método asincrónico posterior a la copia de seguridad invocado por Service Fabric para permitir al usuario completar cualquier actividad posterior a la copia de seguridad antes de devolver el control al sistema. Si se pasa null para esto, no se permiten las copias de seguridad incrementales. Si el método posterior a la copia de seguridad devuelve false, de nuevo, no se permiten las copias de seguridad incrementales.

cancellationToken
CancellationToken

Token para supervisar solicitudes de cancelación.

Devoluciones

Tarea que representa la operación de copia de seguridad asincrónica.

Excepciones

backupDirectory es null cuando backupOption no TruncateLogsOnlyes .

backupDirectory está vacío o solo contiene espacios en blanco cuando backupOption no TruncateLogsOnly es o backupDirectory no es null cuando backupOption es TruncateLogsOnly.

Cuando backupOption es Incremental y el directorio de copia de seguridad ya contiene archivos o subdirectorios.

Cuando una copia de seguridad iniciada anteriormente está en curso.

Ejemplos

A continuación se muestra un ejemplo de una implementación sencilla de postBackupAsyncFunc

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

Comentarios

PostBackupAsyncFunc no se invoca si se produce un error durante la copia de seguridad. Además, no se invoca cuando backupOption es TruncateLogsOnly porque no se necesita ninguna acción adicional del usuario en este caso para completar un único ciclo de copia de seguridad.

Se aplica a