sys.fn_hadr_is_primary_replica(Transact-SQL)
적용 대상: SQL Server
현재 복제본이 주 복제본인지 확인하는 데 사용됩니다.
구문
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)