Export (0) Print
Expand All

sys.availability_group_listeners (Transact-SQL)

For each AlwaysOn availability group, returns either zero rows indicating that no network name is associated with the availability group, or returns a row for each availability-group listener configuration in the Windows Server Failover Clustering (WSFC) cluster. This view displays the real-time configuration gathered from cluster.

Note Note

This catalog view does not describe details of an IP configuration, that was defined in the WSFC cluster.

Applies to: SQL Server (SQL Server 2012 through current version).

Column name

Data type

Description

group_id

uniqueidentifier

Availability group ID (group_id) from sys.availability_groups.

listener_id

nvarchar(36)

GUID from the cluster resource ID.

dns_name

nvarchar(63)

Configured network name (hostname) of the availability group listener.

port

int

The TCP port number configured for the availability group listener.

NULL = Listener was configured outside SQL Server and its port number has not been added to the availability group. To add the port, pleaseuse the MODIFY LISTENER option of the ALTER AVAILABILITY GROUP Transact-SQL statement.

is_conformant

bit

Whether this IP configuration is conformant, one of:

1 = Listener is conformant. Only “OR” relations exist among its Internet Protocol (IP) addresses. Conformant encompasses every an IP configuration that was created by the CREATE AVAILABILITY GROUP Transact-SQL statement. In addition, if an IP configuration that was created outside of SQL Server, for example by using the WSFC Failover Cluster Manager, but can be modified by the ALTER AVAILABILITY GROUP tsql statement, the IP configuration qualifies as conformant.

0 = Listener is nonconformant. Typically, this indicates an IP address that could not be configured by using SQL Server commands and, instead, was defined directly in the WSFC cluster.

ip_configuration_string_from_cluster

nvarchar(max)

Cluster IP configuration strings, if any, for this listener. For example:

  • IPv4 address: 10.120.19.155.

  • IPv6 address: 2001::4898:23:1002:20f:1fff:feff:b3a3

NULL = Listener has no virtual IP addresses.

Permissions

The visibility of the metadata in catalog views is limited to securables that a user either owns or on which the user has been granted some permission. For more information, see Metadata Visibility Configuration.

Community Additions

ADD
Show:
© 2014 Microsoft