sys.fn_hadr_backup_is_preferred_replica (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).
END
-- If this is the preferred replica, continue to do the backup.
使用例
A. sys.fn_hadr_backup_is_preferred_replica を使用する
次の例では、現在のデータベースが推奨されるバックアップ レプリカの場合は 1 を返します。
SELECT sys.fn_hadr_backup_is_preferred_replica ('TestDB');
GO
関連タスク
[先頭に戻る]
関連項目
参照
CREATE AVAILABILITY GROUP (Transact-SQL)
ALTER AVAILABILITY GROUP (Transact-SQL)
概念
アクティブなセカンダリ: セカンダリ レプリカでのバックアップ (AlwaysOn 可用性グループ)