sys.fn_hadr_backup_is_preferred_replica (Transact-SQL)

S’applique à : ouiSQL Server (toutes les versions prises en charge)

Utilisé pour déterminer si le réplica actuel est le réplica de sauvegarde par défaut.

Icône du lien de rubrique Conventions de la syntaxe Transact-SQL

Syntaxe

sys.fn_hadr_backup_is_preferred_replica ( 'dbname' )  

Arguments

'dbname'
Nom de la base de données actuellement sauvegardée. dbname est de type sysname.

Retours

Retourne le type de données bool: 1 si la base de données sur l’instance actuelle se trouve sur le réplica préféré, sinon 0.

Notes

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. Vous pouvez exécuter un script sur chaque réplica de disponibilité. Chacun de ces travaux examine les mêmes données pour déterminer quel travail doit s’exécuter. par conséquent, un seul des travaux planifiés passe à l’étape de sauvegarde. L'exemple de code devrait ressembler à ce qui suit :

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 */

Exemples

R. Utilisation de 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.

SELECT sys.fn_hadr_backup_is_preferred_replica ('TestDB');  
GO  

Voir aussi

Always On les fonctions de groupes de disponibilité (Transact-SQL)
Groupes de disponibilité Always On (SQL Server)
CREATE AVAILABILITY GROUP (Transact-SQL)
ALTER AVAILABILITY GROUP (Transact-SQL)
secondaires actifs : sauvegarde sur les réplicas secondaires (Always On les groupes de disponibilité) Always On affichages catalogue de groupes de disponibilité (Transact-SQL)