sys.fn_hadr_backup_is_preferred_replica (Transact-SQL)sys.fn_hadr_backup_is_preferred_replica (Transact-SQL)

ОБЛАСТЬ ПРИМЕНЕНИЯ: даSQL Server нетБаза данных SQL Azure нетAzure Synapse Analytics (хранилище данных SQL) нетParallel Data Warehouse APPLIES TO: yesSQL Server noAzure SQL Database noAzure Synapse Analytics (SQL DW) noParallel Data Warehouse

Используется для определения, является ли текущая реплика предпочитаемой резервной репликой.Used to determine if the current replica is the preferred backup replica.

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

СинтаксисSyntax

  
sys.fn_hadr_backup_is_preferred_replica ( 'dbname' )  

АргументыArguments

"dbname"'dbname'
Имя базы данных, резервная копия которой создается.Is the name of the database to be backed up. DBName имеет тип sysname.dbname is type sysname.

ВозвращаетReturns

Возвращает 1, если база данных в текущем экземпляре находится в предпочитаемой реплике.Returns 1 if the database on the current instance is on the preferred replica. В противном случае возвращается 0.Otherwise returns 0.

ПримечанияRemarks

Используйте данную функцию в скрипте резервного копирования для определения, доступна ли текущая база данных на реплике, которая является предпочитаемой для резервного копирования.Use this function in a backup script to determine if the current database is on the replica that is preferred for backups. Вы можете запустить скрипт на любой доступной реплике.You can run a script on every availability replica. Каждая из данных задач обращается к одним и тем же данным для определения того, какую задачу следует выполнить, поэтому для создания резервной копии фактически обрабатывается только одна запланированная задача.Each of these jobs looks at the same data to determine which job should run, so only one of the scheduled jobs actually proceeds to the backup stage. Образец кода должен быть аналогичен следующему.Sample code could be similar to the following.

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.  
  

ПримерыExamples

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

В следующем примере возвращаемое значение равно 1, если текущая база данных является предпочитаемой репликой для резервного копия.The following example returns 1 if the current database is the preferred backup replica.

SELECT sys.fn_hadr_backup_is_preferred_replica ('TestDB');  
GO  

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

См. такжеSee Also

Функции групп доступности Always On (Transact-SQL) Always On Availability Groups Functions (Transact-SQL)
Группы доступности AlwaysOn (SQL Server) Always On Availability Groups (SQL Server)
CREATE AVAILABILITY GROUP (Transact-SQL) CREATE AVAILABILITY GROUP (Transact-SQL)
ALTER AVAILABILITY GROUP (Transact-SQL) ALTER AVAILABILITY GROUP (Transact-SQL)
Активные вторичные реплики: Резервного копирования во вторичных репликах (групп доступности Always On)представления каталога групп доступности Always On (Transact-SQL )Active Secondaries: Backup on Secondary Replicas (Always On Availability Groups) Always On Availability Groups Catalog Views (Transact-SQL)