sys.dm_os_cluster_nodes (Transact-SQL)

S’applique à : SQL Server Azure Synapse Analytics Analytics Platform System (PDW)

Retourne une ligne pour chaque nœud de la configuration de l'instance de cluster de basculement. Si l’instance actuelle est une instance en cluster de basculement, elle retourne la liste des nœuds sur lesquels cette instance de cluster de basculement (anciennement « serveur virtuel ») a été définie. Si l'instance de serveur active n'est pas une instance de cluster de basculement, elle retourne un ensemble de lignes vides.

Remarque

Pour l’appeler à partir d’Azure Synapse Analytics ou d’Analytics Platform System (PDW), utilisez le nom sys.dm_pdw_nodes_os_cluster_nodes. Cette syntaxe n’est pas prise en charge par le pool SQL serverless dans Azure Synapse Analytics.

Nom de la colonne	Type de données	Description
NodeName	sysname	Nom d’un nœud dans la configuration de l’instance de cluster de basculement SQL Server (serveur virtuel).
statut	int	État du nœud dans une instance de cluster de basculement SQL Server : 0, 1, 2, 3, -1. Pour plus d’informations, consultez La fonction GetClusterNodeState.
status_description	nvarchar(20)	Description de l’état du nœud du cluster de basculement SQL Server. 0 = actif 1 = inactif 2 = en pause 3 = en cours de jointure -1 = inconnu
is_current_owner	bit	1 signifie que ce nœud est le propriétaire actuel de la ressource de cluster de basculement SQL Server.
pdw_node_id	int	S’applique à : Azure Synapse Analytics, Analytics Platform System (PDW) Identificateur du nœud sur lequel cette distribution est activée.

Notes

Lorsque le clustering de basculement est activé, l’instance SQL Server peut s’exécuter sur l’un des nœuds du cluster de basculement désigné dans le cadre de la configuration de l’instance de cluster de basculement SQL Server (serveur virtuel).

Remarque

Cette vue remplace la fonction fn_virtualservernodes, qui sera déconseillée dans une version ultérieure.

autorisations

Nécessite l’autorisation VIEW SERVER STATE sur l’instance de SQL Server.

Autorisations pour SQL Server 2022 (et versions plus récentes)

Nécessite l’autorisation VIEW SERVER PERFORMANCE STATE sur le serveur.

Exemples

L'exemple suivant utilise sys. dm_os_cluster_nodes pour retourner les nœuds d'une instance de serveur cluster.

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

Voici le jeu de résultats obtenu.

NodeName	statut	status_description	is_current_owner
node1	0	up	1
node2	0	up	0
Node3	1	Éteindre	0

Voir aussi

sys.dm_os_cluster_properties (Transact-SQL)
sys.dm_io_cluster_shared_drives (Transact-SQL)
sys.fn_virtualservernodes (Transact-SQL)
Fonctions et vues de gestion dynamique (Transact-SQL)