sys.dm_os_cluster_nodes (Transact-SQL)

  • [アーティクル]

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

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

注意

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)