共用方式為

sys.fn_hadr_backup_is_preferred_replica (Transact-SQL)

  • 發行項

適用於：SQL Server

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

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).
        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

相關內容