sys.dm_os_cluster_nodes （Transact-SQL）

適用於：SQL Server Azure Synapse Analytics Analytics Platform System （PDW）

針對故障轉移叢集實例組態中的每個節點，各傳回一個數據列。 如果目前的實例是故障轉移叢集實例，則會傳回已定義此故障轉移叢集實例（先前稱為「虛擬伺服器」）的節點清單。 如果目前的伺服器實例不是故障轉移叢集實例，則會傳回空的數據列集。

注意

若要從 Azure Synapse Analytics 或 Analytics Platform System （PDW） 呼叫此專案，請使用名稱 sys.dm_pdw_nodes_os_cluster_nodes。 Azure Synapse Analytics 的無伺服器 SQL 集區不支援此語法。

資料行名稱	資料類型	描述
NodeName	sysname	SQL Server 故障轉移叢集實例 （虛擬伺服器） 組態中的節點名稱。
status	int	SQL Server 故障轉移叢集實例中節點的狀態：0、1、2、3、-1。 如需詳細資訊，請參閱 GetClusterNodeState 函式。
status_description	nvarchar（20）	SQL Server 故障轉移叢集節點的狀態描述。 0 = up 1 = 向下 2 = 已暫停 3 = 聯結 -1 = 未知
is_current_owner	bit	1 表示此節點是 SQL Server 故障轉移叢集資源的目前擁有者。
pdw_node_id	int	適用於：Azure Synapse Analytics、Analytics Platform System (PDW) 此散發節點的標識碼。

備註

啟用故障轉移叢集時，SQL Server 實例可以在指定為 SQL Server 故障轉移叢集實例 （虛擬伺服器） 組態一部分的故障轉移叢集的任何節點上執行。

注意

此檢視會取代fn_virtualservernodes函式，此函式將在未來的版本中淘汰。

權限

需要 SQL Server 實例的 VIEW SERVER STATE 許可權。

SQL Server 2022 和更新版本的權限

需要伺服器上的 VIEW SERVER PERFORMANCE STATE 權限。

範例

下列範例使用 sys。 dm_os_cluster_nodes傳回叢集伺服器實例上的節點。

SELECT NodeName, status, status_description, is_current_owner   
FROM sys.dm_os_cluster_nodes;  

結果集如下所示。

NodeName	status	status_description	is_current_owner
node1	0	up	1
node2	0	up	0
Node3	1	切入	0

另請參閱

sys.dm_os_cluster_properties （Transact-SQL）
sys.dm_io_cluster_shared_drives （Transact-SQL）
sys.fn_virtualservernodes （Transact-SQL）
動態管理檢視和函數 (Transact-SQL)