GetLevel (Datenbank-Engine)

Gilt für:SQL ServerAzure SQL-DatenbankVerwaltete Azure SQL-InstanzSQL-Datenbank in Microsoft Fabric

Gibt einen Integer zurück, der die Tiefe des Knotens this in der Struktur darstellt.

Syntax

-- Transact-SQL syntax  
node.GetLevel ( )   

-- CLR syntax  
SqlInt16 GetLevel ( )   

Rückgabetypen

SQL Server-Rückgabetyp: smallint

CLR-Rückgabetyp: SqlInt16

Remarks

Wird zur Bestimmung der Ebene eines oder mehrerer Knoten oder zur Filterung der Knoten nach Elementen einer bestimmten Ebene verwendet. Der Stamm der Hierarchie ist Ebene 0.

GetLevel ist nützlich für Breitensuchindizes. Weitere Informationen finden Sie unter Hierarchische Daten (SQL Server).

Examples

A. Zurückgeben der Hierarchieebene als Spalte

Im folgenden Beispiel wird eine Textdarstellung von hierarchyid und anschließend die Hierarchieebene als EmpLevel-Spalte für alle Zeilen in der Tabelle zurückgegeben:

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

B. Zurückgeben aller Elemente einer Hierarchieebene

Im folgenden Beispiel werden alle Zeilen in der Tabelle auf Hierarchieebene 2 zurückgegeben:

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

C. Zurückgeben des Stamms der Hierarchie

Im folgenden Beispiel wird der Stamm der Hierarchieebene zurückgegeben.

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

D. CLR-Beispiel

Im folgenden Codeausschnitt wird die GetLevel()-Methode aufgerufen:

this.GetLevel()  

Siehe auch

hierarchyid-Datentyp-Methodenverweis
Hierarchische Daten (SQL Server)
Hierarchie (Transact-SQL)