sys.fn_hadr_backup_is_preferred_replica (Transact-SQL)

Применимо к: даSQL Server (все поддерживаемые версии)

Используется для определения, является ли текущая реплика предпочитаемой резервной репликой.

Значок ссылки на раздел Синтаксические обозначения в Transact-SQL

Синтаксис

sys.fn_hadr_backup_is_preferred_replica ( 'dbname' )  

Аргументы

"dbname"
Имя базы данных, резервная копия которой создается. Аргумент dbname имеет тип sysname.

Возвращаемое значение

Возвращает тип данных bool: 1, если база данных в текущем экземпляре находится на предпочтительной реплике; в противном случае — значение 0.

Remarks

Используйте данную функцию в скрипте резервного копирования для определения, доступна ли текущая база данных на реплике, которая является предпочитаемой для резервного копирования. Вы можете запустить скрипт на любой доступной реплике. Каждая из данных задач обращается к одним и тем же данным для определения того, какую задачу следует выполнить, поэтому для создания резервной копии фактически обрабатывается только одна запланированная задача. Образец кода должен быть аналогичен следующему.

If sys.fn_hadr_backup_is_preferred_replica( @dbname ) <> 1   
BEGIN  
-- If this is not the preferred replica, exit (probably without error).
      Select 'This is not the preferred replica, exiting with success';  
END  
-- If this is the preferred replica, continue to do the backup.  
  /* actual backup command goes here */

Примеры

A. Использование sys.fn_hadr_backup_is_preferred_replica

В следующем примере возвращаемое значение равно 1, если текущая база данных является предпочитаемой репликой для резервного копия.

SELECT sys.fn_hadr_backup_is_preferred_replica ('TestDB');  
GO  

См. также:

функции групп доступности Always On (Transact-SQL)
Группы доступности AlwaysOn (SQL Server)
CREATE AVAILABILITY GROUP (Transact-SQL)
ALTER AVAILABILITY GROUP (Transact-SQL)
активные вторичные реплики: резервное копирование на второстепенных серверах (Always On групп доступности) Always On представления каталога групп доступности (Transact-SQL)