sys.fn_hadr_backup_is_preferred_replica (Transact-SQL)

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

Convenzioni della sintassi Transact-SQL

Sintassi

sys.fn_hadr_backup_is_preferred_replica ( 'dbname' )

Argomenti

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

Valori restituiti

Restituisce 1 se il database nell'istanza corrente è nella replica preferita. In caso contrario, restituisce 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).
END
-- If this is the preferred replica, continue to do the backup.

Esempi

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

• Configurare il backup su repliche di disponibilità (SQL Server)

[Torna all'inizio]

Vedere anche

Riferimento

CREATE AVAILABILITY GROUP (Transact-SQL)

ALTER AVAILABILITY GROUP (Transact-SQL)

Concetti

Gruppi di disponibilità AlwaysOn (SQL Server)

Repliche secondarie attive: Backup in repliche secondarie (Gruppi di disponibilità AlwaysOn)

Altre risorse

Viste del catalogo dei gruppi di disponibilità AlwaysOn (Transact-SQL)