sys.dm_os_cluster_nodes(Transact-SQL)

적용 대상:SQL ServerAzure Synapse Analytics AnalyticsPlatform System(PDW)

장애 조치(failover) 클러스터 인스턴스 구성에 있는 각 노드에 대해 행을 하나씩 반환합니다. 현재 인스턴스가 장애 조치(failover) 클러스터형 인스턴스인 경우에는 이 장애 조치(failover) 클러스터 인스턴스(이전의 "가상 서버"에 해당)가 정의된 노드의 목록을 반환합니다. 현재 서버 인스턴스가 장애 조치(failover) 클러스터형 인스턴스가 아닌 경우에는 빈 행 집합을 반환합니다.

참고 항목

Azure Synapse Analytics 또는 PDW(Analytics Platform System)에서 이를 호출하려면 이름 sys.dm_pdw_nodes_os_cluster_nodes 사용합니다. 이 구문은 Azure Synapse Analytics의 서버리스 SQL 풀에서 지원되지 않습니다.

열 이름	데이터 형식	설명
NodeName	sysname	SQL Server 장애 조치(failover) 클러스터 인스턴스(가상 서버) 구성에 있는 노드의 이름입니다.
status	int	SQL Server 장애 조치(failover) 클러스터 인스턴스의 노드 상태: 0, 1, 2, 3, -1. 자세한 내용은 GetClusterNodeState 함수를 참조 하세요.
status_description	nvarchar(20)	SQL Server 장애 조치(failover) 클러스터 노드의 상태에 대한 설명입니다. 0 = 가동 중 1 = 아래쪽 2 = 일시 중지됨 3 = 조인 -1 = 알 수 없음
is_current_owner	bit	1은 이 노드가 SQL Server 장애 조치(failover) 클러스터 리소스의 현재 소유자임을 의미합니다.
pdw_node_id	int	적용 대상: Azure Synapse Analytics, Analytics Platform System(PDW) 이 배포가 있는 노드의 식별자입니다.

설명

장애 조치(failover) 클러스터링을 사용하도록 설정하면 SQL Server 인스턴스가 SQL Server 장애 조치(failover) 클러스터 인스턴스(가상 서버) 구성의 일부로 지정된 장애 조치(failover) 클러스터의 노드에서 실행될 수 있습니다.

참고 항목

이 보기는 향후 릴리스에서 더 이상 사용되지 않는 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	6
node2	0	up	0
Node3	6	다운	0

참고 항목

sys.dm_os_cluster_properties(Transact-SQL)
sys.dm_io_cluster_shared_drives(Transact-SQL)
sys.fn_virtualservernodes(Transact-SQL)
동적 관리 뷰 및 함수(Transact-SQL)