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

適用対象: ○SQL Server XAzure SQL Database XAzure SQL Data Warehouse XParallel Data WarehouseAPPLIES TO: yesSQL Server noAzure SQL Database noAzure SQL Data Warehouse noParallel Data Warehouse

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

現在のインスタンス上のデータベースが優先レプリカに存在する場合は 1 を返します。Returns 1 if the database on the current instance is on the preferred replica. それ以外の場合 0 を返します。Otherwise returns 0.

コメントRemarks

バックアップ スクリプトでこの関数を使用して、現在のデータベースがバックアップ用に推奨されるレプリカのかを判断します。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  

関連タスクRelated Tasks

関連項目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)