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

CETTE RUBRIQUE S’APPLIQUE À : ouiSQL Server (à partir de la version 2012)nonAzure SQL DatabasenonAzure SQL Data WarehousenonParallel Data Warehouse THIS TOPIC APPLIES TO: yesSQL Server (starting with 2012)noAzure SQL DatabasenoAzure SQL Data Warehouse noParallel Data Warehouse

Utilisé pour déterminer si le réplica actuel est le réplica de sauvegarde par défaut.Used to determine if the current replica is the preferred backup replica.

Icône de lien de rubrique Conventions de la syntaxe Transact-SQLTopic link icon Transact-SQL Syntax Conventions

SyntaxeSyntax


sys.fn_hadr_backup_is_preferred_replica ( 'dbname' )  

ArgumentsArguments

'dbname''dbname'
Nom de la base de données actuellement sauvegardée.Is the name of the database to be backed up. dbname est de type sysname.dbname is type sysname.

Valeur renvoyéeReturns

Retourne 1 si la base de données sur l'instance actuelle est sur le réplica par défaut.Returns 1 if the database on the current instance is on the preferred replica. Dans le cas contraire, retourne la valeur 0.Otherwise returns 0.

NotesRemarks

Utilisez cette fonction dans un script de sauvegarde pour déterminer si la base de données active est sur le réplica préféré pour les sauvegardes.Use this function in a backup script to determine if the current database is on the replica that is preferred for backups. Vous pouvez exécuter un script sur chaque réplica de disponibilité.You can run a script on every availability replica. Chacun de ces travaux recherche les mêmes données pour déterminer quel est le travail à exécuter, une seule des tâches planifiées se poursuit en fait à l’étape de sauvegarde.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. L'exemple de code devrait ressembler à ce qui suit :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.  

ExemplesExamples

A.A. Utilisation de sys.fn_hadr_backup_is_preferred_replicaUsing sys.fn_hadr_backup_is_preferred_replica

L'exemple suivant retourne 1 si la base de données active est le réplica de sauvegarde par défaut.The following example returns 1 if the current database is the preferred backup replica.

SELECT sys.fn_hadr_backup_is_preferred_replica ('TestDB');  
GO  

Tâches associéesRelated Tasks

Voir aussiSee Also

Toujours sur les fonctions de groupes de disponibilité ( Transact-SQL ) Always On Availability Groups Functions (Transact-SQL)
Groupes de disponibilité Always On (SQL Server) Always On Availability Groups (SQL Server)
CREATE AVAILABILITY GROUP (Transact-SQL) CREATE AVAILABILITY GROUP (Transact-SQL)
ALTER AVAILABILITY GROUP (Transact-SQL) ALTER AVAILABILITY GROUP (Transact-SQL)
Secondaires actifs : Sauvegarde sur les réplicas secondaires ( Toujours sur les groupes de disponibilité ) Toujours sur les vues de catalogue de groupes de disponibilité ( Transact-SQL ) Active Secondaries: Backup on Secondary Replicas (Always On Availability Groups) Always On Availability Groups Catalog Views (Transact-SQL)