sys.dm_hadr_cluster_networks (Transact-SQL)
Applies to: SQL Server
Returns a row for every WSFC cluster member that is participating in an availability group's subnet configuration. You can use this dynamic management view to validate the network virtual IP that is configured for each availability replica.
Primary key: member_name
+ network_subnet_ip
+ network_subnet_prefix_length
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) | A computer name of a node in the WSFC cluster. |
network_subnet_ip |
nvarchar(48) | Network IP address of the subnet to which the computer belongs. This can be an IPv4 or IPv6 address. |
network_subnet_ipv4_mask |
nvarchar(45) | Network subnet mask that specifies the subnet to which the IP address belongs. network_subnet_ipv4_mask to specify the DHCP <network_subnet_option> options in a WITH DHCP clause of the CREATE AVAILABILITY GROUP or ALTER AVAILABILITY GROUPTransact-SQL statement.NULL = IPv6 subnet. |
network_subnet_prefix_length |
int | Network IP prefix length that specifies the subnet to which the computer belongs. |
is_public |
bit | Whether the network is private or public on the WSFC cluster, one of: 0 = Private 1 = Public |
is_ipv4 |
bit | Type of the subnet, one of: 1 = IPv4 0 = IPv6 |
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.