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 relative alla 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 bit del tipo di dati: 1 se il database nell'istanza corrente si trova nella replica preferita, in caso contrario 0.

Per i database che non fanno parte di un gruppo di disponibilità, questa funzione restituisce 1sempre .

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

Contenuto correlato