sys.fn_hadr_is_primary_replica (Transact-SQL)

Область применения: SQL Server (все поддерживаемые версии)

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

Соглашения о синтаксисе Transact-SQL

Синтаксис

sys.fn_hadr_is_primary_replica ( 'dbname' )  

Аргументы

'dbname'
Имя базы данных. dbname имеет тип sysname.

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

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

Комментарии

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

If sys.fn_hadr_is_primary_replica ( @dbname ) <> 1   
BEGIN  
-- If this is not the primary replica, exit (probably without error).  
END  
-- If this is the primary replica, continue to do the backup.  

Примеры

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

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

SELECT sys.fn_hadr_is_primary_replica ('TestDB');  
GO  

Безопасность

Разрешения

необходимо разрешение VIEW SERVER STATE на сервере.

См. также:

Функции групп доступности Always On (Transact-SQL)
sys.dm_hadr_database_replica_states (Transact-SQL)группы доступности Always On (SQL Server)
CREATE AVAILABILITY GROUP (Transact-SQL)
ALTER AVAILABILITY GROUP (Transact-SQL)
Представления каталога групп доступности Always On (Transact-SQL)