sys.fn_hadr_is_primary_replica (Transact-SQL)

Aplica-se a:SQL Server

Usado para determinar se a réplica atual é a réplica primária.

Transact-SQL convenções de sintaxe

Sintaxe

sys.fn_hadr_is_primary_replica ( 'dbname' )  

Argumentos

'dbname'
É o nome do banco de dados. dbname é digite sysname.

Devoluções

Retorna o tipo de dados bit: 1 se o banco de dados na instância atual for a réplica primária, caso contrário, 0.
Retorna NULL se o banco de dados não existir ou não fizer parte de um grupo de disponibilidade.

Comentários

Use essa função para determinar convenientemente se a instância local está hospedando a réplica primária do banco de dados de disponibilidade especificado. O código de exemplo pode ser semelhante ao seguinte.

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.  

Exemplos

Um. Usando sys.fn_hadr_is_primary_replica

O exemplo a seguir retornará 1 se o banco de dados especificado na instância local for a réplica primária.

SELECT sys.fn_hadr_is_primary_replica ('TestDB');  
GO  

Segurança

Permissões

Requer a permissão VIEW SERVER STATE no servidor.

Ver também

Funções de grupos de disponibilidade Always On (Transact-SQL)
sys.dm_hadr_database_replica_states (Transact-SQL)Grupos de disponibilidade Always On (SQL Server)
CRIAR GRUPO DE DISPONIBILIDADE (Transact-SQL)
GRUPO ALTERAR DISPONIBILIDADE (Transact-SQL)
Visualizações de catálogo de grupos de disponibilidade Always On (Transact-SQL)