sys.fn_hadr_backup_is_preferred_replica (Transact-SQL)

  • 發行項

適用於：SQL Server

用於判斷目前的複本是否為慣用的備份複本。

Transact-SQL 語法慣例

語法

sys.fn_hadr_backup_is_preferred_replica ( 'dbname' )

引數

'dbname'
這是要備份的資料庫名稱。 dbname 是 sysname 類型。

傳回

傳回數據類型 bool：如果目前實例上的資料庫位於慣用複本上，則傳回 1，否則為 0。

備註

在備份文本中使用這個函式來判斷目前資料庫是否位於備份慣用的複本上。 您可以在每個可用性複本上執行文稿。 每個作業都會查看相同的數據，以判斷應該執行的作業，因此只有其中一個排程工作實際上會繼續進行備份階段。 範例程式代碼可能如下所示。

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

相關工作

另請參閱

AlwaysOn 可用性群組函式 （Transact-SQL）
Always On 可用性群組 (SQL Server)
CREATE AVAILABILITY GROUP (Transact-SQL)
ALTER AVAILABILITY GROUP (Transact-SQL)
使用中次要：次要復本上的備份（AlwaysOn 可用性群組）AlwaysOn 可用性群組目錄檢視 （Transact-SQL）