Udostępnij za pośrednictwem

sys.fn_hadr_is_primary_replica (Transact-SQL)

  • Artykuł

Dotyczy:programu SQL Server

Służy do określania, czy bieżąca replika jest repliką podstawową.

Transact-SQL konwencje składni

Składnia

sys.fn_hadr_is_primary_replica ( 'dbname' )

Argumenty

'dbname'
To nazwa bazy danych. nazwa_bazy_danych jest typem sysname.

Zwraca

Zwraca typ danych bit: 1, jeśli baza danych w bieżącym wystąpieniu jest repliką podstawową, w przeciwnym razie 0.
Zwraca NULL, jeśli baza danych nie istnieje lub nie jest częścią grupy dostępności.

Uwagi

Użyj tej funkcji, aby wygodnie określić, czy wystąpienie lokalne hostuje replikę podstawową określonej bazy danych dostępności. Przykładowy kod może być podobny do poniższego.

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.

Przykłady

A. Korzystanie z sys.fn_hadr_is_primary_replica

Poniższy przykład zwraca wartość 1, jeśli określona baza danych w wystąpieniu lokalnym jest repliką podstawową.

SELECT sys.fn_hadr_is_primary_replica ('TestDB');  
GO

Bezpieczeństwo

Uprawnienia

Wymaga uprawnienia WYŚWIETL STAN SERWERA na serwerze.

Zobacz też

funkcje zawsze włączonych grup dostępności (Transact-SQL)
sys.dm_hadr_database_replica_states (Transact-SQL)zawsze włączone grupy dostępności (SQL Server)
CREATE AVAILABILITY GROUP (Transact-SQL)
ALTER AVAILABILITY GROUP (Transact-SQL)
widoków wykazu zawsze włączonych grup dostępności (Transact-SQL)