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)