Partilhar via


GetLevel (Mecanismo de Banco de Dados)

Retorna um inteiro que representa a profundidade do nó this na árvore.

Sintaxe

-- Transact-SQL syntax
node.GetLevel ( ) 

-- CLR syntax
SqlInt16 GetLevel ( ) 

Tipos de retorno

Tipo de retorno do SQL Server: smallint

Tipo de retorno CLR: SqlInt16

Comentários

Usado para determinar o nível de um ou mais nós ou para filtrar os nós de membros de um nível especificado. A raiz da hierarquia é nível 0.

GetLevel é muito útil para índices de busca primeiro em largura. Para obter mais informações, consulte Dados hierárquicos (SQL Server).

Exemplos

A.Retornando o nível de hierarquia como uma coluna

O exemplo a seguir retorna uma representação de texto de hierarchyid e, depois, o nível de hierarquia como a coluna EmpLevel para todas as linhas na tabela:

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

B.Retornando todos os membros de um nível de hierarquia

O seguinte exemplo retorna todas as linhas na tabela no nível de hierarquia 2:

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

C.Retornando a raiz da hierarquia

O seguinte exemplo retorna a raiz da árvore do nível de hierarquia:

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

D.Exemplo de CLR

O seguinte trecho de código chama o método GetLevel():

this.GetLevel()

Consulte também

Referência

hierarchyid (Transact-SQL)

Conceitos

Referência de método de tipo de dados hierarchyid

Dados hierárquicos (SQL Server)