GetLevel (moteur de base de données)

Article
12/22/2023

S’applique à :SQL Server Azure SQL Database Azure SQL Managed Instance

Retourne un entier qui représente la profondeur du nœud this dans l’arborescence.

Syntaxe

-- Transact-SQL syntax  
node.GetLevel ( )

-- CLR syntax  
SqlInt16 GetLevel ( )

Remarque

Pour afficher la syntaxe Transact-SQL pour SQL Server 2014 (12.x) et versions antérieures, consultez la Documentation sur les versions antérieures.

Types de retour

Type de retour SQL Server : smallint

Type de retour CLR : SqlInt16

Remarques

Sert à déterminer le niveau d'un ou plusieurs nœuds ou à filtrer les nœuds afin d'obtenir les membres d'un niveau spécifié. La racine de la hiérarchie est le niveau 0.

GetLevel est utile pour les index de recherche à largeur prioritaire. Pour plus d’informations, consultez Données hiérarchiques (SQL Server).

Exemples

R. Retour du niveau hiérarchique en tant que colonne

L’exemple suivant retourne une représentation textuelle du hierarchyid, puis le niveau hiérarchique en tant que colonne EmpLevel pour toutes les lignes de la table :

SELECT OrgNode.ToString() AS Text_OrgNode,   
OrgNode.GetLevel() AS EmpLevel, *  
FROM HumanResources.EmployeeDemo;

B. Retour de tous les membres d'un niveau hiérarchique

L'exemple suivant retourne toutes les lignes de la table au niveau hiérarchique 2 :

SELECT OrgNode.ToString() AS Text_OrgNode,   
OrgNode.GetLevel() AS EmpLevel, *  
FROM HumanResources.EmployeeDemo  
WHERE OrgNode.GetLevel() = 2;

C. Retour de la racine de la hiérarchie

L'exemple suivant retourne la racine du niveau hiérarchique :

SELECT OrgNode.ToString() AS Text_OrgNode,   
OrgNode.GetLevel() AS EmpLevel, *  
FROM HumanResources.EmployeeDemo  
WHERE OrgNode.GetLevel() = 0;

D. Exemple CLR

L’extrait de code suivant appelle la méthode GetLevel() :

this.GetLevel()

Voir aussi

Référence de méthodes de type de données hierarchyid
Données hiérarchiques (SQL Server)
hierarchyid (Transact-SQL)

Share via