Share via

sys.fn_hadr_backup_is_preferred_replica (Transact-SQL)

  • Articolo

Si applica a:SQL Server

Utilizzato per determinare se la replica corrente è la replica di backup preferita.

Convenzioni di sintassi Transact-SQL

Sintassi

sys.fn_hadr_backup_is_preferred_replica ( 'dbname' )

Argomenti

'dbname'
Nome del database di cui eseguire il backup. dbname è di tipo sysname.

Valori restituiti

Restituisce il tipo di dati bool: 1 se il database nell'istanza corrente si trova nella replica preferita, in caso contrario 0.

Osservazioni:

Utilizzare questa funzione in uno script di backup per determinare se il database corrente si trova nella replica preferita per i backup. È possibile eseguire uno script in ogni replica di disponibilità. Ognuno di questi processi analizza gli stessi dati per determinare il processo da eseguire in modo tale che solo uno dei processi pianificati procede effettivamente alla fase di backup. Il codice di esempio avrà un aspetto analogo al seguente:

If sys.fn_hadr_backup_is_preferred_replica( @dbname ) <> 1   
BEGIN  
-- If this is not the preferred replica, exit (probably without error).
      Select 'This is not the preferred replica, exiting with success';  
END  
-- If this is the preferred replica, continue to do the backup.  
  /* actual backup command goes here */

Esempi

R. Utilizzo di sys.fn_hadr_backup_is_preferred_replica

Nell'esempio seguente viene restituito 1 se il database corrente è la replica di backup preferita.

SELECT sys.fn_hadr_backup_is_preferred_replica ('TestDB');  
GO

Attività correlate

Vedi anche

Funzioni dei gruppi di disponibilità AlwaysOn (Transact-SQL)
Gruppi di disponibilità Always On (SQL Server)
CREATE AVAILABILITY GROUP (Transact-SQL)
ALTER AVAILABILITY GROUP (Transact-SQL)
Repliche secondarie attive: backup in repliche secondarie (gruppi di disponibilità AlwaysOn)Viste del catalogo dei gruppi di disponibilità AlwaysOn (Transact-SQL)