sp_wait_for_database_copy_sync(活动异地副本 (replica))

适用于:Azure SQL 数据库Azure SQL 托管实例

此过程的范围限定为主数据库和辅助数据库之间的活动异地复制关系。 sys.sp_wait_for_database_copy_sync调用会导致应用程序等待,直到活动辅助数据库副本 (replica)并确认所有已提交的事务。 sys.sp_wait_for_database_copy_sync仅在主数据库上运行。

语法

sp_wait_for_database_copy_sync [ @target_server = ] 'server_name'
     , [ @target_database = ] 'database_name'

参数

[ @target_server = ] 'server_name'

承载活动辅助数据库的Azure SQL 数据库服务器的名称。 server_namesysname,没有默认值。

[ @target_database = ] 'database_name'

活动辅助数据库的名称。 database_name为 sysname,无默认值。

返回代码值

返回 0 表示成功,返回错误编号表示失败。

最有可能发生的错误情况如下:

  • 缺少服务器名称或数据库名称。

  • 找不到指向指定服务器名称或数据库的链接。

  • 连接连接已丢失,连接 sys.sp_wait_for_database_copy_sync 超时后将返回。

权限

主数据库中的任何用户均可调用此系统存储过程。 登录名必须是主数据库和活动辅助数据库中的用户。

注解

在调用发送到活动辅助数据库之前 sp_wait_for_database_copy_sync 提交的所有事务。

示例

以下示例调用 sp_wait_for_database_copy_sync 以确保所有事务都提交到主数据库, AdventureWorks并将其发送到目标服务器上的 serverSecondary活动辅助数据库。

USE AdventureWorks;
GO
EXEC sys.sp_wait_for_database_copy_sync @target_server = N'serverSecondary', @target_database = N'AdventureWorks';
GO