sys.dm_hadr_cluster_members (Transact-SQL)
Applies to: SQL Server Azure SQL Database
If the WSFC node that hosts a local instance of SQL Server that is enabled for Always On availability groups has WSFC quorum, returns a row for each of the members that constitute the quorum and the state of each of them. This includes of all nodes in the cluster (returned with CLUSTER_ENUM_NODE
type by the Clusterenum
function) and the disk or file-share witness, if any. The row returned for a given member contains information about the state of that member. For example, for a five node cluster with majority node quorum in which one node is down, when sys.dm_hadr_cluster_members
is queried from a server instance that is enabled for Always On availability groups that resides on a node with quorum, sys.dm_hadr_cluster_members
reflects the state of the down node as NODE_DOWN
.
If the WSFC node has no quorum, no rows are returned.
Use this dynamic management view to answer the following questions:
What nodes are currently running on the WSFC cluster?
How many more failures can the WSFC cluster tolerate before losing quorum in a majority-node case?
Tip
Beginning in SQL Server 2014 (12.x), this dynamic management view supports Always On failover cluster instances (FCIs) in addition to availability groups (AGs).
Column name | Data type | Description |
---|---|---|
member_name |
nvarchar(128) | Member name, which can be a computer name, a drive letter, or a file share path. |
member_type |
tinyint | The type of member, one of: 0 = WSFC node 1 = Disk witness 2 = File share witness 3 = Cloud Witness |
member_type_desc |
nvarchar(50) | Description of member_type , one of:CLUSTER_NODE DISK_WITNESS FILE_SHARE_WITNESS CLOUD_WITNESS |
member_state |
tinyint | The member state, one of: 0 = Offline 1 = Online |
member_state_desc |
nvarchar(60) | Description of member_state , one of:UP DOWN |
number_of_quorum_votes |
tinyint | Number of quorum votes possessed by this quorum member. For No Majority: Disk Only quorums, this value defaults to 0. For other quorum types, this value defaults to 1. |
Remarks
In a Windows Server Failover Cluster (WSFC), the cluster columns display the Windows cluster details. In cases where there's no Windows cluster, such as read-scale availability groups, or availability groups on Linux, columns related to the cluster might display data about an internal default cluster. These columns are for internal use only and can be disregarded.
Permissions
For SQL Server 2019 (15.x) and previous versions, requires VIEW SERVER STATE permission on the server.
For SQL Server 2022 (16.x) and later versions, requires VIEW SERVER PERFORMANCE STATE permission on the server.