sys.availability_group_listeners (Transact-SQL)

  • Artigo

Aplica-se a:SQL Server

Para cada grupo de disponibilidade Always On, retorna zero linhas indicando que nenhum nome de rede está associado ao grupo de disponibilidade ou retorna uma linha para cada configuração de ouvinte de grupo de disponibilidade no cluster do WSFC (Windows Server Failover Clustering). Essa exibição exibe a configuração em tempo real coletada do cluster.

Observação

Essa exibição do catálogo não descreve detalhes de uma configuração de IP, que foi definida no cluster do WSFC.

Nome da coluna Tipo de dados Descrição
group_id uniqueidentifier ID do grupo de disponibilidade (group_id) do sys.availability_groups.
listener_id nvarchar(36) GUID da ID do recurso do cluster.
dns_name Nvarchar(63) Nome de rede configurado (nome do host) do ouvinte do grupo de disponibilidade.
porta int O número da porta TCP configurada para o ouvinte do grupo de disponibilidade.

NULL = O ouvinte foi configurado fora do SQL Server e seu número de porta não foi adicionado ao grupo de disponibilidade. Para adicionar a porta, use a opção MODIFY LISTENER da instrução ALTER AVAILABILITY GROUPTransact-SQL.
is_conformant bit Se esta configuração de IP é compatível, pode ser:

1 = O ouvinte é compatível. Existem apenas relações "OR" entre seus endereços IP (Internet Protocol). Conformant engloba todas as configurações de IP criadas pela instrução CREATE AVAILABILITY GROUPTransact-SQL. Além disso, se uma configuração de IP que foi criada fora do SQL Server, por exemplo, usando o Gerenciador de Cluster de Failover WSFC, mas pode ser modificada pela instrução ALTER AVAILABILITY GROUP tsql, a configuração de IP se qualifica como conforme.

0 = O ouvinte não é compatível. Normalmente, isso indica um endereço IP que não pôde ser configurado usando comandos do SQL Server e, em vez disso, foi definido diretamente no cluster WSFC.
ip_configuration_string_from_cluster nvarchar(max) Cadeias de caracteres da configuração de IP do cluster, se houver, para esse ouvinte. NULL = O ouvinte não tem nenhum endereço IP virtual. Por exemplo:

Endereço IPv4: 65.55.39.10.

Endereço IPv6: 2001::4898:23:1002:20f:1fff:feff:b3a3
is_distributed_network_name bit Aplica-se a: SQL Server 2019 (15.x) CU8 e posterior, SQL Server 2017 (14.x) CU25 e posterior, SQL Server 2016 (13.x) SP3 e posterior

Esta coluna indica que o ouvinte é um ouvinte de nome de rede distribuído (DNN) se o valor for definido como 1. Para obter mais informações, consulte Configurar um ouvinte DNN para um grupo de disponibilidade

Segurança

Permissões

A visibilidade dos metadados em exibições de catálogo é limitada a protegíveis que um usuário possui ou nos quais o usuário recebeu alguma permissão. Para obter mais informações, consulte Metadata Visibility Configuration.

Confira também