sys.dm_os_cluster_nodes(Transact-SQL)

적용 대상: SQL Server Azure Synapse Analytics Analytics Platform 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	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)