sys.fn_hadr_backup_is_preferred_replica (Transact-SQL)sys.fn_hadr_backup_is_preferred_replica (Transact-SQL)

QUESTO ARGOMENTO SI APPLICA A: sìSQL Server (a partire dalla versione 2012)noAzure SQL DatabasenoAzure SQL Data Warehouse noParallel Data Warehouse THIS TOPIC APPLIES TO: yesSQL Server (starting with 2012)noAzure SQL DatabasenoAzure SQL Data Warehouse noParallel Data Warehouse

Utilizzato per determinare se la replica corrente è la replica di backup preferita.Used to determine if the current replica is the preferred backup replica.

Icona di collegamento a un argomentoConvenzioni della sintassi Transact-SQLTopic link icon Transact-SQL Syntax Conventions

SintassiSyntax


sys.fn_hadr_backup_is_preferred_replica ( 'dbname' )  

ArgomentiArguments

'dbname''dbname'
Nome del database di cui eseguire il backup.Is the name of the database to be backed up. dbname è di tipo sysname.dbname is type sysname.

Valori di codice restituitiReturns

Restituisce 1 se il database nell'istanza corrente è nella replica preferita.Returns 1 if the database on the current instance is on the preferred replica. In caso contrario, restituisce 0.Otherwise returns 0.

OsservazioniRemarks

Utilizzare questa funzione in uno script di backup per determinare se il database corrente si trova nella replica preferita per i backup.Use this function in a backup script to determine if the current database is on the replica that is preferred for backups. È possibile eseguire uno script in ogni replica di disponibilità.You can run a script on every availability replica. 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.Each of these jobs looks at the same data to determine which job should run, so only one of the scheduled jobs actually proceeds to the backup stage. Il codice di esempio avrà un aspetto analogo al seguente:Sample code could be similar to the following.

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.  

EsempiExamples

A.A. Utilizzo di sys.fn_hadr_backup_is_preferred_replicaUsing sys.fn_hadr_backup_is_preferred_replica

Nell'esempio seguente viene restituito 1 se il database corrente è la replica di backup preferita.The following example returns 1 if the current database is the preferred backup replica.

SELECT sys.fn_hadr_backup_is_preferred_replica ('TestDB');  
GO  

Attività correlateRelated Tasks

Vedere ancheSee Also

Funzioni ( gruppi di disponibilità AlwaysOn Transact-SQL ) Always On Availability Groups Functions (Transact-SQL)
Gruppi di disponibilità Always On (SQL Server) Always On Availability Groups (SQL Server)
CREARE il gruppo di disponibilità ( Transact-SQL ) CREATE AVAILABILITY GROUP (Transact-SQL)
ALTER AVAILABILITY GROUP (Transact-SQL) ALTER AVAILABILITY GROUP (Transact-SQL)
Repliche secondarie attive: Backup in repliche secondarie ( Sempre in gruppi di disponibilità ) Always On le viste del catalogo di gruppi di disponibilità ( Transact-SQL ) Active Secondaries: Backup on Secondary Replicas (Always On Availability Groups) Always On Availability Groups Catalog Views (Transact-SQL)