다음을 통해 공유


sys.fn_hadr_backup_is_preferred_복제본(replica)(Transact-SQL)

적용 대상: SQL Server

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

Transact-SQL 구문 표기 규칙

구문

sys.fn_hadr_backup_is_preferred_replica ( 'dbname' )

인수

'dbname'

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

반품

데이터 형식 비트를1 반환합니다. 현재 인스턴스의 데이터베이스가 기본 설정 복제본에 있으면 그렇지 않습니다0.

가용성 그룹에 속하지 않는 데이터베이스의 경우 이 함수는 항상 반환합니다 1.

설명

백업 스크립트에서 이 함수를 사용하여 현재 데이터베이스가 백업에 선호되는 복제본에 있는지 확인합니다. 모든 가용성 복제본에서 스크립트를 실행할 수 있습니다. 이러한 각 작업은 동일한 데이터를 확인하여 실행해야 하는 작업을 결정하므로 예약된 작업 중 하나만 실제로 백업 단계로 진행됩니다. 샘플 코드는 다음과 유사할 수 있습니다.

IF sys.fn_hadr_backup_is_preferred_replica(@dbname) <> 1
    BEGIN
-- If this is not the preferred replica, exit (probably without error).
        SELECT 'This is not the preferred replica, exiting with success';
    END
-- If this is the preferred replica, continue to do the backup.
/* actual backup command goes here */

예제

A. sys.fn_hadr_backup_is_preferred_replica 사용

다음은 현재 데이터베이스가 기본 백업 복제본인 경우 1을 반환하는 예제입니다.

SELECT sys.fn_hadr_backup_is_preferred_replica('TestDB');
GO