sys.fn_hadr_is_primary_replica (Transact-SQL)

Artikel
01/07/2025

van toepassing op:SQL Server-

Wordt gebruikt om te bepalen of de huidige replica de primaire replica is.

Syntaxis

sys.fn_hadr_is_primary_replica ( 'dbname' )

Argumenten

'dbname'
Is de naam van de database. dbname typt u sysname.

Retourneert

Retourneert het gegevenstype bit: 1 als de database op het huidige exemplaar de primaire replica is, anders 0.
Retourneert NULL als de database niet bestaat of geen deel uitmaakt van een beschikbaarheidsgroep.

Opmerkingen

Gebruik deze functie om eenvoudig te bepalen of het lokale exemplaar als host fungeert voor de primaire replica van de opgegeven beschikbaarheidsdatabase. Voorbeeldcode kan er ongeveer als volgt uitzien.

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.

Voorbeelden

Een. Sys.fn_hadr_is_primary_replica gebruiken

In het volgende voorbeeld wordt 1 geretourneerd als de opgegeven database op het lokale exemplaar de primaire replica is.

SELECT sys.fn_hadr_is_primary_replica ('TestDB');  
GO

Veiligheid

Machtigingen

Vereist de machtiging VIEW SERVER STATE op de server.

Zie ook

Functies van AlwaysOn-beschikbaarheidsgroepen (Transact-SQL)
sys.dm_hadr_database_replica_states (Transact-SQL)AlwaysOn-beschikbaarheidsgroepen (SQL Server)
CREATE AVAILABILITY GROUP (Transact-SQL)
ALTER AVAILABILITY GROUP (Transact-SQL)
Catalogusweergaven van AlwaysOn-beschikbaarheidsgroepen (Transact-SQL)

Delen via