sys.fn_hadr_is_primary_replica (Transact-SQL)

Aplica-se a: SQL Server (todas as versões com suporte)

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

Topic link iconConvenções de sintaxe do Transact-SQL

Sintaxe

sys.fn_hadr_is_primary_replica ( 'dbname' )  

Argumentos

'dbname'
É o nome do banco de dados. dbname é o nome do tipo.

Retornos

Retorna o bit do tipo de dados: 1 se o banco de dados na instância atual for a réplica primária, caso contrário, 0.

Comentários

Use esta função para determinar se aparentemente 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

a. 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

, é necessário ter permissão VIEW SERVER STATE no servidor.

Consulte Também

Always On funções de grupos de disponibilidade (Transact-SQL)
sys.dm_hadr_database_replica_states (Transact-SQL)Always On Grupos de Disponibilidade (SQL Server)
CREATE AVAILABILITY GROUP (Transact-SQL)
ALTER AVAILABILITY GROUP (Transact-SQL)
Exibições de catálogo de Grupos de Disponibilidade AlwaysOn (Transact-SQL)