sys.fn_hadr_backup_is_preferred_replica (Transact-sql)sys.fn_hadr_backup_is_preferred_replica (Transact-SQL)

適用対象:Applies to: はいSQL ServerSQL Server (サポートされているすべてのバージョン) yesSQL ServerSQL Server (all supported versions) 適用対象:Applies to: はいSQL ServerSQL Server (サポートされているすべてのバージョン) yesSQL ServerSQL Server (all supported versions)

現在のレプリカが推奨されるバックアップ レプリカであるかどうかを決定するために使用されます。Used to determine if the current replica is the preferred backup replica.

トピック リンク アイコン Transact-SQL 構文表記規則Topic link icon Transact-SQL Syntax Conventions

構文Syntax

  
sys.fn_hadr_backup_is_preferred_replica ( 'dbname' )  

引数Arguments

'dbname''dbname'
バックアップするデータベースの名前です。Is the name of the database to be backed up. dbname の型は sysname です。dbname is type sysname.

戻り値Returns

現在のインスタンス上のデータベースが優先レプリカ上にある場合は、データ型 bool: 1 を返します。それ以外の場合は0を返します。Returns data type bool: 1 if the database on the current instance is on the preferred replica, otherwise 0.

RemarksRemarks

バックアップスクリプトでこの関数を使用して、現在のデータベースがバックアップに適したレプリカに存在するかどうかを確認します。Use this function in a backup script to determine if the current database is on the replica that is preferred for backups. すべての可用性レプリカでスクリプトを実行できます。You can run a script on every availability replica. これらの各ジョブは、どのジョブを実行するかを決定するために同じデータを確認するので、スケジュールされたジョブの1つだけがバックアップステージに進みます。Each of these jobs looks at the same data to determine which job should run, so only one of the scheduled jobs actually proceeds to the backup stage. サンプル コードは次のようになります。Sample code could be similar to the following.

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.  
  

Examples

A.A. sys.fn_hadr_backup_is_preferred_replica を使用するUsing sys.fn_hadr_backup_is_preferred_replica

次の例では、現在のデータベースが推奨されるバックアップレプリカである場合、1を返します。The following example returns 1 if the current database is the preferred backup replica.

SELECT sys.fn_hadr_backup_is_preferred_replica ('TestDB');  
GO  

参照See Also

Always On 可用性グループの関数 (Transact-sql) Always On Availability Groups Functions (Transact-SQL)
AlwaysOn 可用性グループ (SQL Server) Always On Availability Groups (SQL Server)
CREATE AVAILABILITY GROUP (Transact-SQL) CREATE AVAILABILITY GROUP (Transact-SQL)
ALTER AVAILABILITY GROUP (Transact-SQL) ALTER AVAILABILITY GROUP (Transact-SQL)
アクティブなセカンダリ: セカンダリレプリカでのバックアップ (Always On 可用性グループ) Always On 可用性グループのカタログビュー (transact-sql) Active Secondaries: Backup on Secondary Replicas (Always On Availability Groups) Always On Availability Groups Catalog Views (Transact-SQL)