sys.fn_hadr_backup_is_preferred_replica (Transact-SQL)

現在のレプリカが推奨されるバックアップ レプリカであるかどうかを決定するために使用されます。

トピック リンク アイコン 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 可用性グループ (SQL Server)

アクティブなセカンダリ: セカンダリ レプリカでのバックアップ (AlwaysOn 可用性グループ)

その他の技術情報

AlwaysOn 可用性グループ カタログ ビュー (Transact-SQL)