sys.fn_hadr_is_primary_replica (Transact-SQL)

Artikel
01/07/2025

gäller för:SQL Server

Används för att avgöra om den aktuella repliken är den primära repliken.

Syntax

sys.fn_hadr_is_primary_replica ( 'dbname' )

Argument

"dbname"
Är namnet på databasen. dbname är typen sysname.

Returnerar

Returnerar datatypen bit: 1 om databasen på den aktuella instansen är den primära repliken, annars 0.
Returnerar NULL om databasen inte finns eller inte ingår i en tillgänglighetsgrupp.

Anmärkningar

Använd den här funktionen för att enkelt avgöra om den lokala instansen är värd för den primära repliken av den angivna tillgänglighetsdatabasen. Exempelkoden kan likna följande.

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.

Exempel

A. Använda sys.fn_hadr_is_primary_replica

Följande exempel returnerar 1 om den angivna databasen på den lokala instansen är den primära repliken.

SELECT sys.fn_hadr_is_primary_replica ('TestDB');  
GO

Säkerhet

Behörigheter

Kräver tillståndsbehörighet för VIEW SERVER på servern.

Se även

AlwaysOn-funktioner för tillgänglighetsgrupper (Transact-SQL)
sys.dm_hadr_database_replica_states (Transact-SQL)AlwaysOn-tillgänglighetsgrupper (SQL Server)
SKAPA TILLGÄNGLIGHETSGRUPP (Transact-SQL)
ÄNDRA TILLGÄNGLIGHETSGRUPP (Transact-SQL)
katalogvyer för AlwaysOn-tillgänglighetsgrupper (Transact-SQL)

Dela via