KeyValueStoreReplica.BackupAsync Método

Definición

Espacio de nombres:

System.Fabric

Ensamblado:

System.Fabric.dll

Paquete:

Microsoft.ServiceFabric v9.1.1833

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

Task

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

Excepciones

ArgumentNullException

backupDirectory es null cuando backupOption no TruncateLogsOnlyes .

ArgumentException

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

FabricBackupDirectoryNotEmptyException

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

FabricBackupInProgressException

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.

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

Task

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

Excepciones

ArgumentNullException

backupDirectory es null cuando backupOption no TruncateLogsOnlyes .

ArgumentException

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

FabricBackupDirectoryNotEmptyException

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

FabricBackupInProgressException

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.