sys.dm_os_cluster_nodes (Transact-SQL)

適用対象: SQL Server Azure Synapse Analytics Analytics Platform System (PDW)

フェールオーバー クラスター インスタンス構成のノードごとに 1 行を返します。 現在のインスタンスがフェールオーバー クラスター化インスタンスの場合、このフェールオーバー クラスター インスタンス (以前の "仮想サーバー") が定義されているノードの一覧が返されます。 現在のサーバー インスタンスがフェールオーバー クラスター インスタンスではない場合は、空の行セットを返します。

Note

これを 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 = down 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 フェールオーバー クラスター インスタンス (仮想サーバー) 構成の一部として指定されているフェールオーバー クラスターの任意のノードで実行できます。

Note

このビューは、将来のリリースで非推奨となる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
ノード 1	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)