sys.fn_hadr_backup_is_preferred_replica (Transact-SQL)

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

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.

Valeurs retournées

Retourne 1 si la base de données sur l'instance actuelle est le réplica par défaut. Dans le cas contraire, retourne la valeur 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 recherche les mêmes données pour déterminer quel est le travail à exécuter, de sorte qu'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).
END
-- If this is the preferred replica, continue to do the backup.

Exemples

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

Tâches associées

• Configurer la sauvegarde sur des réplicas de disponibilité (SQL Server)

[Haut de la page]

Voir aussi

Référence

CREATE AVAILABILITY GROUP (Transact-SQL)

ALTER AVAILABILITY GROUP (Transact-SQL)

Concepts

Groupes de disponibilité AlwaysOn (SQL Server)

Sauvegarde sur des réplicas secondaires (groupes de disponibilité AlwaysOn)

Autres ressources

Vues de catalogue des groupes de disponibilité AlwaysOn (Transact-SQL)