sys.fn_hadr_backup_is_preferred_реплика (Transact-SQL)

Применимо к:SQL Server

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

Соглашения о синтаксисе 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 */

Примеры

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

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

SELECT sys.fn_hadr_backup_is_preferred_replica ('TestDB');  
GO  

Связанные задачи

См. также

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