sys.fn_hadr_backup_is_preferred_replica (Transact-SQL)

用于确定当前副本是否为首选备份副本。

适用范围:SQL Server(SQL Server 2012 到当前版本)。

主题链接图标 Transact-SQL 语法约定

语法

sys.fn_hadr_backup_is_preferred_replica ( 'dbname' )

参数

  • 'dbname'
    要备份的数据库的名称。 dbname 的类型为 sysname。

返回

如果当前实例上的数据库位于首选副本上,则返回 1。 否则,返回 0。

注释

在备份脚本中使用此函数来确定当前数据库是否位于用于备份的首选副本上。 您可以在每个可用性副本上运行脚本。 上述每个作业都应该查看相同数据以便确定哪一作业应该运行,因此,实际上只有一个计划作业将前进到备份阶段。 示例代码可与以下代码相似。

If sys.fn_hadr_backup_is_preferred_replica( @dbname ) <> 1 
BEGIN
-- If this is not the preferred replica, exit (probably without error).
END
-- If this is the preferred replica, continue to do the backup.

示例

A.使用 sys.fn_hadr_backup_is_preferred_replica

如果当前数据库是首选备份副本,则下面的示例将返回 1。

SELECT sys.fn_hadr_backup_is_preferred_replica ('TestDB');
GO

相关任务

用于“返回首页”链接的箭头图标[返回页首]

请参阅

参考

CREATE AVAILABILITY GROUP (Transact-SQL)

ALTER AVAILABILITY GROUP (Transact-SQL)

概念

AlwaysOn 可用性组函数 (Transact-SQL)

AlwaysOn 可用性组 (SQL Server)

活动辅助副本:辅助副本备份(AlwaysOn 可用性组)

其他资源

AlwaysOn 可用性组目录视图 (Transact-SQL)