sys.fn_hadr_backup_is_preferred_replica (Transact-SQL)
適用対象: 
SQL Server
現在のレプリカが推奨されるバックアップ レプリカであるかどうかを決定するために使用されます。
構文
sys.fn_hadr_backup_is_preferred_replica ( 'dbname' )
引数
'dbname'
バックアップするデータベースの名前。 dbname は sysname 型です。
返品
データ型 bit: 現在のインスタンス上のデータベースが優先レプリカにある場合は 1 を返します。それ以外の場合は 0。
可用性グループに含まれていないデータベースの場合、この関数は常に 1を返します。
解説
バックアップ スクリプトでこの関数を使用して、現在のデータベースがバックアップに適したレプリカ上にあるかどうかを判断します。 すべての可用性レプリカでスクリプトを実行できます。 これらの各ジョブは同じデータを調べて実行するジョブを決定するため、スケジュールされたジョブの 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