Compartilhar via

sys.fn_hadr_is_primary_replica (Transact-SQL)

  • Artigo

Aplica-se: SQL Server

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

Convenções de sintaxe de Transact-SQL

Sintaxe

sys.fn_hadr_is_primary_replica ( 'dbname' )

Argumentos

'dbname'
É o nome do banco de dados. dbname é o tipo 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.

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

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

Confira também

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