sys.fn_hadr_backup_is_preferred_replica (Transact-SQL)

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

Применимо для следующих объектов: SQL Server (начиная с SQL Server 2012 до текущей версии).

Значок ссылки на раздел Cинтаксические обозначения в 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.

Примеры

А.Использование 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)