GetLevel (Datenbank-Engine)

Artikel
12/22/2023

Gilt für:SQL Server Azure SQL-Datenbank Azure SQL Managed Instance

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 ( )

Hinweis

Informationen zum Anzeigen der Transact-SQL-Syntax für SQL Server 2014 (12.x) und früher finden Sie unter Dokumentation zu früheren Versionen.

Rückgabetypen

SQL Server-Rückgabetyp: smallint

CLR-Rückgabetyp: SqlInt16

Hinweise

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).

Beispiele

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()

Weitere Informationen

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

Share via