sys.fn_hadr_is_primary_replica (Transact-SQL)

  • Artikel

Gilt für:SQL Server

Dient zum Ermitteln, ob das aktuelle Replikat das primäre Replikat ist.

Transact-SQL-Syntaxkonventionen

Syntax

sys.fn_hadr_is_primary_replica ( 'dbname' )

Argumente

'dbname'
Der Name der Datenbank. "dbname" ist vom Typ "sysname ".

Gibt zurück

Gibt den Datentyp Bit zurück: 1, wenn die Datenbank in der aktuellen Instanz das primäre Replikat ist, andernfalls 0.

Hinweise

Verwenden Sie diese Funktion, um leicht zu bestimmen, ob die lokale Instanz das primäre Replikat der angegebenen Verfügbarkeitsdatenbank hostet. Beispielcode kann sich wie folgt zusammensetzen.

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.

Beispiele

.A Verwenden von sys.fn_hadr_is_primary_replica

Im folgenden Beispiel wird 1 zurückgegeben, wenn die angegebene Datenbank auf der lokalen Instanz das primäre Replikat ist.

SELECT sys.fn_hadr_is_primary_replica ('TestDB');  
GO

Sicherheit

Berechtigungen

Erfordert die VIEW SERVER STATE-Berechtigung auf dem Server.

Weitere Informationen

Always On Availability Groups Functions (Transact-SQL)
sys.dm_hadr_database_replica_states (Transact-SQL)Always On Availability Groups (SQL Server)
CREATE AVAILABILITY GROUP (Transact-SQL)
ALTER AVAILABILITY GROUP (Transact-SQL)
Katalogsichten für Always On-Verfügbarkeitsgruppen (Transact-SQL)