Partager via


sys.fn_hadr_is_primary_replica (Transact-SQL)

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

S'applique à : SQL Server (SQL Server 2014 via la version actuelle).

Icône Lien de rubrique Conventions de syntaxe Transact-SQL

Syntaxe

sys.fn_hadr_is_primary_replica ( 'dbname' )

Argument

  • 'dbname'
    Nom de la base de données. dbname est de type sysname.

Valeur de retour

Retourne 1 si la base de données sur l'instance actuelle est le réplica principal par défaut. Dans le cas contraire, retourne la valeur 0.

Notes

Utilisez cette fonction pour déterminer aisément si l'instance locale héberge le réplica principal de la base de données de disponibilité spécifiée. L'exemple de code devrait ressembler à ce qui suit :

If sys.fn_hadr_is_primary_replica ( @dbname ) <> 1 
BEGIN
-- If this is not the primary replica, exit (probably without error).
END
-- If this is the primary replica, continue to do the backup.

Exemple

A.Utilisation de sys.fn_hadr_is_primary_replica

L'exemple suivant retourne 1 si la base de données spécifiée sur l'instance locale est le réplica principal.

SELECT sys.fn_hadr_is_primary_replica ('TestDB');
GO

Voir aussi

Référence

CREATE AVAILABILITY GROUP (Transact-SQL)

ALTER AVAILABILITY GROUP (Transact-SQL)

Concepts

Fonctions de groupes de disponibilité AlwaysOn (Transact-SQL)

Groupes de disponibilité AlwaysOn (SQL Server)

Autres ressources

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