sys.fn_hadr_is_primary_replica (Transact-SQL)

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

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

Conventions de la syntaxe Transact-SQL

Syntaxe

sys.fn_hadr_is_primary_replica ( 'dbname' )  

Arguments

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

Retours

Retourne le type de données bit : 1 si la base de données sur l’instance actuelle est le réplica principal, sinon 0.

Remarques

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.  

Exemples

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

Sécurité

Autorisations

requièrent l'autorisation VIEW SERVER STATE sur le serveur.

Voir aussi

fonctions de groupes de disponibilité Always On (Transact-SQL)
sys.dm_hadr_database_replica_states (Transact-SQL)Always On groupes de disponibilité (SQL Server)
CREATE AVAILABILITY GROUP (Transact-SQL)
ALTER AVAILABILITY GROUP (Transact-SQL)
Affichages du catalogue des groupes de disponibilité Always On (Transact-SQL)