sys.fn_hadr_backup_is_preferred_replica (Transact-SQL)

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

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

Topic link iconСинтаксические обозначения в 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).
      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)