Muokkaa

Jaa

sys.dm_hadr_cluster_members (Transact-SQL)

Applies to: SQL Server Azure SQL Database SQL database in Microsoft Fabric

If the Windows Server failover cluster (WSFC) node hosts a local instance of SQL Server that is enabled for Always On availability groups and has WSFC quorum, the view returns a row for each member that constitutes the quorum, and the state of that member. This set includes 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 you query sys.dm_hadr_cluster_members 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, the view returns no rows.

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 Nullable Description
member_name nvarchar(256) No Member name, which can be a computer name, a drive letter, or a file share path.
member_type tinyint No The type of member, one of:

0 = WSFC node
1 = Disk witness
2 = File share witness
3 = Cloud witness
member_type_desc nvarchar(60) No Description of member_type, one of:

CLUSTER_NODE
DISK_WITNESS
FILE_SHARE_WITNESS
CLOUD_WITNESS
member_state tinyint No The member state, one of:

0 = Offline
1 = Online
member_state_desc nvarchar(60) No Description of member_state, one of:

UP
DOWN
number_of_quorum_votes int Yes Number of quorum votes that you can assign to this quorum member. For No Majority: Disk Only quorums, this value defaults to 0. For other quorum types, this value defaults to 1.
number_of_current_votes int Yes Number of quorum votes currently assigned to this quorum member. This value is dynamic and reflects the actual quorum value assigned by dynamic quorum and dynamic witness.

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 earlier versions, you need VIEW SERVER STATE permission on the server.

For SQL Server 2022 (16.x) and later versions, you need VIEW SERVER PERFORMANCE STATE permission on the server.

Related content

  • Last updated on