sys.fn_hadr_is_primary_replica (Transact-SQL)

Článek
01/07/2025

platí pro:SQL Server

Slouží k určení, jestli je aktuální replika primární replikou.

Syntax

sys.fn_hadr_is_primary_replica ( 'dbname' )

Argumenty

dbname
Je název databáze. dbname je typ sysname.

Návraty

Vrátí datový typ bit: 1, pokud je databáze v aktuální instanci primární replikou, jinak 0.
Vrátí NULL, pokud databáze neexistuje nebo není součástí skupiny dostupnosti.

Poznámky

Pomocí této funkce můžete pohodlně určit, jestli místní instance hostuje primární repliku zadané databáze dostupnosti. Vzorový kód může být podobný následujícímu.

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.

Příklady

A. Použití sys.fn_hadr_is_primary_replica

Následující příklad vrátí hodnotu 1, pokud zadaná databáze v místní instanci je primární replikou.

SELECT sys.fn_hadr_is_primary_replica ('TestDB');  
GO

Bezpečnost

Dovolení

Vyžaduje oprávnění ZOBRAZIT STAV SERVERU na serveru.

Viz také

funkce skupin dostupnosti AlwaysOn (Transact-SQL)
sys.dm_hadr_database_replica_states (Transact-SQL)skupiny dostupnosti AlwaysOn (SQL Server)
vytvoření skupiny dostupnosti (Transact-SQL)
ALTER AVAILABILITY GROUP (Transact-SQL)
zobrazení katalogu skupin dostupnosti AlwaysOn (Transact-SQL)

Sdílet prostřednictvím