다음을 통해 공유


sys.fn_hadr_is_primary_replica(Transact-SQL)

적용 대상: SQL Server

현재 복제본이 주 복제본인지 확인하는 데 사용됩니다.

Transact-SQL 구문 표기 규칙

구문

sys.fn_hadr_is_primary_replica ( 'dbname' )  

인수

'dbname'
데이터베이스의 이름입니다. dbname 은 sysname 형식입니다.

반품

데이터 형식 비트를 반환합니다. 현재 인스턴스의 데이터베이스가 주 복제본이면 1이고, 그렇지 않으면 0을 반환합니다.

설명

이 함수를 사용하여 로컬 인스턴스가 지정된 가용성 데이터베이스의 주 복제본을 호스팅하는지 여부를 편리하게 확인할 수 있습니다. 샘플 코드는 다음과 유사할 수 있습니다.

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.  

예제

A. sys.fn_hadr_is_primary_replica 사용

다음 예에서는 로컬 인스턴스에 지정된 데이터베이스가 주 복제본인 경우 1을 반환합니다.

SELECT sys.fn_hadr_is_primary_replica ('TestDB');  
GO  

보안

사용 권한

서버에 대한 VIEW SERVER STATE 권한이 필요합니다.

참고 항목

Always On 가용성 그룹 함수(Transact-SQL)
sys.dm_hadr_database_replica_states(Transact-SQL)Always On 가용성 그룹(SQL Server)
CREATE AVAILABILITY GROUP(Transact-SQL)
ALTER AVAILABILITY GROUP(Transact-SQL)
Always On 가용성 그룹 카탈로그 뷰(Transact-SQL)