sys.fn_hadr_is_primary_replica （Transact-SQL）

適用於：SQL Server

用於判斷目前的複本是否為主要複本。

Transact-SQL 語法慣例

語法

sys.fn_hadr_is_primary_replica ( 'dbname' )  

引數

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

傳回

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

備註

使用此函式可方便判斷本機實例是否裝載指定可用性資料庫的主要複本。 範例程式代碼可能如下所示。

If sys.fn_hadr_is_primary_replica ( @dbname ) <> 1   
BEGIN  
-- If this is not the primary replica, exit (probably without error).  
END  
-- If this is the primary replica, continue to do the backup.  

範例

A. 使用 sys.fn_hadr_is_primary_replica

如果本機實例上的指定資料庫是主要複本，則下列範例會傳回 1。

SELECT sys.fn_hadr_is_primary_replica ('TestDB');  
GO  

安全性

權限

需要伺服器上的 VIEW SERVER STATE 許可權。

另請參閱

AlwaysOn 可用性群組函式 （Transact-SQL）
sys.dm_hadr_database_replica_states （Transact-SQL）AlwaysOn 可用性群組 （SQL Server）
CREATE AVAILABILITY GROUP (Transact-SQL)
ALTER AVAILABILITY GROUP (Transact-SQL)
Always On 可用性群組目錄檢視 (Transact-SQL)