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