通过

你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

RestoreContext.RestoreAsync 方法

  • 参考

定义

命名空间:
Microsoft.ServiceFabric.Data
程序集:
Microsoft.ServiceFabric.Data.Interfaces.dll
包:
Microsoft.ServiceFabric.Data.Interfaces v6.1.1583

重载

RestoreAsync(RestoreDescription)

还原 由 描述的 RestoreDescription备份。
RestoreAsync(RestoreDescription, CancellationToken)

还原 由 描述的 RestoreDescription备份。

RestoreAsync(RestoreDescription)

还原 由 描述的 RestoreDescription备份。

public System.Threading.Tasks.Task RestoreAsync (Microsoft.ServiceFabric.Data.RestoreDescription restoreDescription);
member this.RestoreAsync : Microsoft.ServiceFabric.Data.RestoreDescription -> System.Threading.Tasks.Task
Public Function RestoreAsync (restoreDescription As RestoreDescription) As Task

参数

restoreDescription
RestoreDescription

还原请求的说明。

返回

Task

表示异步还原操作的任务。

例外

FabricMissingFullBackupException

指示输入备份文件夹不包含完整备份。 要使备份文件夹可还原，它必须恰好包含一个完整备份和任意数量的增量备份。

ArgumentException

指示其中一个参数无效。 例如，还原 Reliable Service 时，如果 RestorePolicy 设置为“安全”，但输入备份文件夹包含的状态版本早于当前副本 (replica) 中维护的状态。

还原执行组件服务时，如果指定 BackupFolderPath 为空，则会引发此异常。

DirectoryNotFoundException

指示提供的还原目录不存在。

FabricObjectClosedException

指示副本 (replica) 正在关闭。

InvalidOperationException

指示当前还原操作无效。 例如， ServicePartitionKind 从中执行备份的分区的 不同于正在还原的当前分区。

FileNotFoundException

指示在提供的还原目录下找不到预期的备份文件。

FabricException

指示还原操作遇到意外错误或还原目录中的备份文件无效。 属性 ErrorCode 指示发生的错误类型。

  • InvalidBackup 指示还原目录中提供的备份文件缺少文件或具有额外的意外文件。
  • InvalidRestoreData 指示还原目录中存在的 (restore.dat) 元数据文件已损坏或包含无效信息。
  • InvalidBackupChain 指示备份链 (，即在还原目录中提供) 后创建的一个完整备份和零个或多个连续增量备份已损坏。
  • DuplicateBackups 指示备份链 (，即在还原目录中提供) 之后创建的一个完整备份和零个或多个连续增量备份包含重复备份。
  • RestoreSafeCheckFailed 如果 Safe 指定为 的 RestoreDescription一部分，则表示为还原提供的备份的数据早于服务中当前存在的数据。

注解

必须从 OnDataLossAsync 方法调用此 API。 在任何给定时间点，每个副本 (replica) 只能有一个 RestoreAsync API 在运行时。

请注意，此 API 引发的异常因基础状态提供程序而异。 此 API 当前记录的异常仅适用于 Service Fabric for Reliable Services 和 Reliable Actors 提供的现成状态提供程序。

在 Reliable Service 中调用时，此 API 会引发以下异常：

使用 KvsActorStateProvider 作为其状态提供程序 (作为 Reliable Actors) 的默认状态提供程序的 Actor 服务中调用时，此 API 将引发以下异常：

适用于

RestoreAsync(RestoreDescription, CancellationToken)

还原 由 描述的 RestoreDescription备份。

public System.Threading.Tasks.Task RestoreAsync (Microsoft.ServiceFabric.Data.RestoreDescription restoreDescription, System.Threading.CancellationToken cancellationToken);
member this.RestoreAsync : Microsoft.ServiceFabric.Data.RestoreDescription * System.Threading.CancellationToken -> System.Threading.Tasks.Task
Public Function RestoreAsync (restoreDescription As RestoreDescription, cancellationToken As CancellationToken) As Task

参数

restoreDescription
RestoreDescription

还原请求的说明。

cancellationToken
CancellationToken

要监视取消请求的标记。

返回

Task

表示异步还原操作的任务。

例外

FabricMissingFullBackupException

指示输入备份文件夹不包含完整备份。 要使备份文件夹可还原，它必须恰好包含一个完整备份和任意数量的增量备份。

ArgumentException

指示其中一个参数无效。 例如，还原 Reliable Service 时，如果 RestorePolicy 设置为“安全”，但输入备份文件夹包含的状态版本早于当前副本 (replica) 中维护的状态。

还原执行组件服务时，如果指定 BackupFolderPath 为空，则会引发此异常。

DirectoryNotFoundException

指示提供的还原目录不存在。

FabricObjectClosedException

指示副本 (replica) 正在关闭。

InvalidOperationException

指示当前还原操作无效。 例如， ServicePartitionKind 从中执行备份的分区的 不同于正在还原的当前分区。

FileNotFoundException

指示在提供的还原目录下找不到预期的备份文件。

FabricException

指示还原操作遇到意外错误或还原目录中的备份文件无效。 属性 ErrorCode 指示发生的错误类型。

  • InvalidBackup 指示还原目录中提供的备份文件缺少文件或具有额外的意外文件。
  • InvalidRestoreData 指示还原目录中存在的 (restore.dat) 元数据文件已损坏或包含无效信息。
  • InvalidBackupChain 指示备份链 (，即在还原目录中提供) 后创建的一个完整备份和零个或多个连续增量备份已损坏。
  • DuplicateBackups 指示备份链 (，即在还原目录中提供) 之后创建的一个完整备份和零个或多个连续增量备份包含重复备份。
  • RestoreSafeCheckFailed 如果 Safe 指定为 的 RestoreDescription一部分，则表示为还原提供的备份的数据早于服务中当前存在的数据。

注解

必须从 OnDataLossAsync 方法调用此 API。 在任何给定时间点，每个副本 (replica) 只能有一个 RestoreAsync API 在运行时。

请注意，此 API 引发的异常因基础状态提供程序而异。 此 API 当前记录的异常仅适用于 Service Fabric for Reliable Services 和 Reliable Actors 提供的现成状态提供程序。

在 Reliable Service 中调用时，此 API 会引发以下异常：

使用 KvsActorStateProvider 作为其状态提供程序 (作为 Reliable Actors) 的默认状态提供程序的 Actor 服务中调用时，此 API 将引发以下异常：

适用于