PATHITEM
position
関数の評価結果の文字列から、指定した PATH の項目を返します。 位置は左から右にカウントされます。
構文
PATHITEM(<path>, <position>[, <type>])
パラメーター
用語 | 定義 |
---|---|
path |
PATH 関数の結果の形式のテキスト文字列。 |
position |
返される項目の位置を持つ整数式。 |
type |
(省略可能)結果のデータ型を定義する列挙体: |
type 列挙型
列挙 | 代替列挙型 | 形容 |
---|---|---|
TEXT |
0 | 結果は、データ型のテキストと共に返されます。 (既定値)。 |
INTEGER |
1 | 結果は整数として返されます。 |
戻り値
識別子のリスト内の指定した位置にある PATH 関数によって返される識別子。 PATH 関数によって返される項目は、最も遠い順に並べ替えされます。
備考
この関数を使用すると、PATH 関数によって返される階層から特定のレベルを返すことができます。 たとえば、すべての従業員のスキップ レベルのマネージャーだけを返す場合があります。
1 未満または
path
内の要素の数より大きいposition
の数を指定すると、PATHITEM 関数は BLANK を返します。type
が有効な列挙要素でない場合は、エラーが返されます。この関数は、計算列または行レベル セキュリティ (RLS) 規則で使用する場合、DirectQuery モードでは使用できません。
例
次の例では、現在の従業員の第 3 層マネージャーを返します。従業員 ID とマネージャー ID は、親の階層を持つ文字列を現在の従業員に返す PATH 関数への入力として受け取ります。 その文字列から PATHITEM は、3 番目のエントリを整数として返します。
= PATHITEM(PATH(Employee[EmployeeKey], Employee[ParentEmployeeKey]), 3, 1)