sys.fn_hadr_is_primary_replica (Transact-SQL)

Articolo
08/21/2023

Si applica a:SQL Server

Utilizzato per determinare se la replica corrente è la replica primaria.

Sintassi

sys.fn_hadr_is_primary_replica ( 'dbname' )

Argomenti

'dbname'
Nome del database. dbname è di tipo sysname.

Valori restituiti

Restituisce il bit del tipo di dati: 1 se il database nell'istanza corrente è la replica primaria, in caso contrario 0.

Osservazioni:

Utilizzare questa funzione per determinare se l'istanza locale ospita la replica primaria del database di disponibilità specificato. Il codice di esempio avrà un aspetto analogo al seguente:

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.

Esempi

R. Utilizzo di sys.fn_hadr_is_primary_replica

Nell'esempio seguente viene restituito 1 se il database specificato nell'istanza locale è la replica primaria.

SELECT sys.fn_hadr_is_primary_replica ('TestDB');  
GO

Sicurezza

Autorizzazioni

È richiesta l'autorizzazione VIEW SERVER STATE per il server.

Vedi anche

Funzioni dei gruppi di disponibilità AlwaysOn (Transact-SQL)
sys.dm_hadr_database_replica_states (Transact-SQL)Gruppi di disponibilità AlwaysOn (SQL Server)
CREATE AVAILABILITY GROUP (Transact-SQL)
ALTER AVAILABILITY GROUP (Transact-SQL)
Viste del catalogo dei Gruppi di disponibilità Always On (Transact-SQL)

Condividi tramite