sys.dm_hadr_cluster_members (Transact-SQL)

Aplica-se a: Banco de Dados SQL do Azure do SQL Server

Se o nó WSFC que hospeda uma instância local do SQL Server habilitada para grupos de disponibilidade Always On tiver quorum WSFC, retornará uma linha para cada um dos membros que constituem o quorum e o estado de cada um deles. Isso inclui todos os nós no cluster (retornados com CLUSTER_ENUM_NODE o Clusterenum tipo pela função) e a testemunha de disco ou compartilhamento de arquivos, se houver. A linha retornada para um determinado membro contém informações sobre o estado daquele membro. Por exemplo, para um cluster de cinco nós com quorum de nó principal no qual um nó está inativo, quando sys.dm_hadr_cluster_members é consultado de uma instância de servidor habilitada para grupos de disponibilidade Always On que reside em um nó com quorum, sys.dm_hadr_cluster_members reflete o estado do nó inativo como NODE_DOWN.

Se o nó WSFC não tiver nenhum quorum, nenhuma linha será retornada.

Use essa exibição de gerenciamento dinâmico pode responder às seguintes perguntas:

  • Quais nós estão sendo executados no cluster WSFC atualmente?

  • Quantas falhas mais o cluster WSFC pode tolerar antes de perder o quorum em um caso de maioria de nós?

Dica

A partir do SQL Server 2014 (12.x), essa exibição de gerenciamento dinâmico dá suporte a FCIs (instâncias de cluster de failover) Always On, além de AGs (grupos de disponibilidade).

Nome da coluna Tipo de dados Descrição
member_name nvarchar(128) Nome do membro, que pode ser um nome de computador, uma letra de unidade ou um caminho de compartilhamento de arquivos.
member_type tinyint O tipo do membro, um dos seguintes:

0 = Nó WSFC

1 = Testemunha de disco
2 = Testemunha de compartilhamento de arquivos
3 = Testemunha da Nuvem
member_type_desc nvarchar(50) Descrição de member_type, um dos seguintes:

CLUSTER_NODE
DISK_WITNESS
FILE_SHARE_WITNESS
CLOUD_WITNESS
member_state tinyint O estado do membro, um dos seguintes:

0 = Offline
1 = Online
member_state_desc nvarchar(60) Descrição de member_state, um dos seguintes:

UP
DOWN
number_of_quorum_votes tinyint Número de votos de quorum possuído por este membro de quorum. Para nenhuma maioria: quorums de somente disco, esse valor é padronizado como 0. Para outros tipos de quorum, este valor é padronizado como 1.

Comentários

Em um WSFC (Cluster de Failover do Windows Server), as colunas de cluster exibem os detalhes do cluster do Windows. Nos casos em que não há nenhum cluster do Windows, como grupos de disponibilidade de escala de leitura ou grupos de disponibilidade no Linux, as colunas relacionadas ao cluster podem exibir dados sobre um cluster padrão interno. Essas colunas são somente para uso interno e podem ser desconsideradas.

Permissões

Para SQL Server 2019 (15.x) e versões anteriores, requer a permissão VIEW SERVER STATE no servidor.

Para SQL Server 2022 (16.x) e versões posteriores, requer a permissão VIEW SERVER PERFORMANCE STATE no servidor.