次の方法で共有


GetDescendant (データベース エンジン)

parent の子ノードを返します。

構文

-- Transact-SQL syntax
parent.GetDescendant ( child1 , child2 ) 

-- CLR syntax
SqlHierarchyId GetDescendant ( SqlHierarchyId child1 , SqlHierarchyId child2 ) 

引数

  • child1
    NULL または現在のノードの子の hierarchyid。

  • child2
    NULL または現在のノードの子の hierarchyid。

戻り値の型

SQL Server の戻り値の型 : hierarchyid

CLR の戻り値の型 : SqlHierarchyId

説明

parent の子孫である 1 つの子ノードを返します。

  • parent が NULL の場合、NULL を返します。

  • parent が NULL でなく、child1 と child2 の両方が NULL の場合、parent の子を返します。

  • parent と child1 が NULL でなく、child2 が NULL の場合、child1 より大きい parent の子を返します。

  • parent と child2 が NULL でなく、child1 が NULL の場合、child2 より小さい parent の子を返します。

  • parent、child1、child2 が NULL でない場合、child1 より大きく child2 より小さい parent の子を返します。

  • child1 が NULL でなく parent の子でない場合、例外が発生します。

  • child2 が NULL でなく parent の子でない場合、例外が発生します。

  • child1 >= child2 の場合は、例外が発生します。

GetDescendant は決定的です。 したがって、GetDescendant を同じ入力で呼び出すと、常に同じ出力が生成されます。 ただし、生成される子の実際の ID は、例 C に示すように、他のノードとの関係によって異なります。

使用例

A. 最も小さい子孫ノードとして行を挿入

ノード /3/1/ の既存の従業員の部下として新しい従業員が採用されました。 次のコードを実行して新しい行を挿入します。このコードでは、GetDescendant メソッドを引数なしで使用して、新しい行のノードを /3/1/1/ として指定しています。

DECLARE @Manager hierarchyid 
SELECT @Manager = CAST('/3/1/' AS hierarchyid)

INSERT HumanResources.EmployeeDemo (OrgNode, LoginID, Title, HireDate)
VALUES
(@Manager.GetDescendant(NULL, NULL),
'adventure-works\FirstNewEmployee', 'Application Intern', '3/11/07') ;

B. 大きい子孫ノードとして行を挿入

例 A と同じ上司の部下として別の新しい従業員が採用されました。 次のコードを実行して新しい行を挿入します。このコードでは、child 1 引数を使用する GetDescendant メソッドを使用して、新しい行のノードが例 A のノードに続くノード /3/1/2/ になるように指定しています。

DECLARE @Manager hierarchyid, @Child1 hierarchyid

SELECT @Manager = CAST('/3/1/' AS hierarchyid)
SELECT @Child1 = CAST('/3/1/1/' AS hierarchyid)

INSERT HumanResources.EmployeeDemo (OrgNode, LoginID, Title, HireDate)
VALUES
(@Manager.GetDescendant(@Child1, NULL),
'adventure-works\SecondNewEmployee', 'Application Intern', '3/11/07') ;

C. 既存の 2 つのノードの間に行を挿入

例 A と同じ上司の部下として 3 人目の従業員が採用されました。 この例では、例 A の FirstNewEmployee より大きく、例 B の SecondNewEmployee より小さいノードに新しい行を挿入します。 GetDescendant メソッドを使用して次のコードを実行します。 このコードでは、child1 引数と child2 引数の両方を使用して、新しい行のノードがノード /3/1/1.1/ になるように指定しています。

DECLARE @Manager hierarchyid, @Child1 hierarchyid, @Child2 hierarchyid

SELECT @Manager = CAST('/3/1/' AS hierarchyid)
SELECT @Child1 = CAST('/3/1/1/' AS hierarchyid)
SELECT @Child2 = CAST('/3/1/2/' AS hierarchyid)

INSERT HumanResources.EmployeeDemo (OrgNode, LoginID, Title, HireDate)
VALUES
(@Manager.GetDescendant(@Child1, @Child2),
'adventure-works\ThirdNewEmployee', 'Application Intern', '3/11/07') ;

A、B、および C の 3 つの例が完了すると、テーブルに追加されたノードは、以下の hierarchyid 値を持つピアになります。

/3/1/1/

/3/1/1.1/

/3/1/2/

ノード /3/1/1.1/ は、ノード /3/1/1/ より大きいノードですが、階層のレベルは同じです。

D. スカラーの例

SQL Server では、任意の hierarchyid ノードを自由に挿入および削除できます。GetDescendant() を使用すると、いつでも、任意の 2 つの hierarchyid ノードの間にノードを生成できます。 次のコードを実行すると、GetDescendant を使用してサンプル ノードが生成されます。

DECLARE @h hierarchyid = hierarchyid::GetRoot()
DECLARE @c hierarchyid = @h.GetDescendant(NULL, NULL)
SELECT @c.ToString()
DECLARE @c2 hierarchyid = @h.GetDescendant(@c, NULL)
SELECT @c2.ToString()
SET @c2 = @h.GetDescendant(@c, @c2)
SELECT @c2.ToString()
SET @c = @h.GetDescendant(@c, @c2)
SELECT @c.ToString()
SET @c2 = @h.GetDescendant(@c, @c2)
SELECT @c2.ToString()

E. CLR の例

次のコード例では GetDescendant() メソッドを呼び出します。

SqlHierarchyId parent, child1, child2;
parent = SqlHierarchyId.GetRoot();
child1 = parent.GetDescendant(SqlHierarchyId.Null, SqlHierarchyId.Null);
child2 = parent.GetDescendant(child1, SqlHierarchyId.Null);
Console.Write(parent.GetDescendant(child1, child2).ToString());

関連項目

参照

hierarchyid (Transact-SQL)

概念

hierarchyid データ型メソッド リファレンス

階層データ (SQL Server)