Share via


sys.fn_hadr_backup_is_preferred_replica (Transact-SQL)

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

主題連結圖示 Transact-SQL 語法慣例

語法

sys.fn_hadr_backup_is_preferred_replica ( 'dbname' )

引數

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

傳回值

如果目前執行個體上的資料庫為慣用複本,則傳回 1, 否則傳回 0。

備註

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

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)