sys.dm_os_cluster_nodes (Transact-SQL)

Aplica-se a: SQL Server Azure Synapse Analytics Analytics Platform System (PDW)

Retorna uma linha para cada nó na configuração de instância de cluster de failover. Se a instância atual for uma instância clusterizada, ela retornará uma lista de nós nos quais essa instância de cluster de failover (anteriormente "servidor virtual") foi definida. Se a instância de servidor atual não for uma instância clusterizada de failover, ela retornará um conjunto de linhas vazio.

Observação

Para chamar isso do Azure Synapse Analytics ou do PDW (Analytics Platform System), use o nome sys.dm_pdw_nodes_os_cluster_nodes. Não há suporte a essa sintaxe para o pool de SQL sem servidor no Azure Synapse Analytics.

Nome da coluna	Tipo de dados	Descrição
Nome do nó	sysname	Nome de um nó na configuração da instância do cluster de failover do SQL Server (servidor virtual).
status	int	Status do nó em uma instância de cluster de failover do SQL Server: 0, 1, 2, 3, -1. Para obter mais informações, consulte Função GetClusterNodeState.
status_description	nvarchar(20)	Descrição do status do nó do cluster de failover do SQL Server. 0 = ativo 1 = inativo 2 = pausado 3 = unindo -1 = desconhecido
is_current_owner	bit	1 significa que esse nó é o proprietário atual do recurso de cluster de failover do SQL Server.
pdw_node_id	int	Aplica-se a: Azure Synapse Analytics, Analytics Platform System (PDW) O identificador do nó em que essa distribuição está ativada.

Comentários

Quando o clustering de failover está habilitado, a instância do SQL Server pode ser executada em qualquer um dos nós do cluster de failover designados como parte da configuração da instância do cluster de failover do SQL Server (servidor virtual).

Observação

Essa exibição substitui a função fn_virtualservernodes, que será preterida em uma versão futura.

Permissões

Requer a permissão VIEW SERVER STATE na instância do SQL Server.

Permissões do SQL Server 2022 e posteriores

É necessária a permissão VIEW SERVER PERFORMANCE STATE no servidor.

Exemplos

O exemplo a seguir usa sys. dm_os_cluster_nodes para retornar os nós em uma instância de servidor clusterizado.

SELECT NodeName, status, status_description, is_current_owner   
FROM sys.dm_os_cluster_nodes;  

Este é o conjunto de resultados.

NodeName	status	status_description	is_current_owner
node1	0	up	1
node2	0	up	0
Node3	1	ligar	0

Confira também

sys.dm_os_cluster_properties (Transact-SQL)
sys.dm_io_cluster_shared_drives (Transact-SQL)
sys.fn_virtualservernodes (Transact-SQL)
Exibições e funções de gerenciamento dinâmico (Transact-SQL)