Поделиться через


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.  

Примеры

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

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

SELECT sys.fn_hadr_is_primary_replica ('TestDB');  
GO  

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

Разрешения

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

См. также

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