PATH
現在の識別子のすべての親の識別子を含む区切りテキスト文字列を返します。最も古い文字列から始まり、現在まで続きます。
構文
PATH(<ID_columnName>, <parent_columnName>)
パラメーター
用語 | 定義 |
---|---|
ID_columnName |
テーブル内の行の一意識別子を含む既存の列の名前。 式にすることはできません。
ID_columnName の値のデータ型は、テキストまたは整数である必要があり、また、parent_columnName で参照される列と同じデータ型である必要があります。 |
parent_columnName |
現在の行の親の一意識別子を含む既存の列の名前。 式にすることはできません。
parent_columnName データ型の値のデータ型は、テキストまたは整数である必要があり、ID_columnName の値と同じデータ型である必要があります。 |
戻り値
現在の識別子のすべての親の識別子を含む区切りテキスト文字列。
備考
この関数は、現在の行の値に関連する項目を返すために、何らかの内部階層を持つテーブルで使用されます。 たとえば、従業員、従業員のマネージャー、マネージャーを含む Employees テーブルでは、従業員を上司に接続するパスを返すことができます。
パスは、親子リレーションシップの単一レベルに制限されません。指定した開始行から数レベル上の関連行を返すことができます。
- アセンダントを区切るために使用される区切り記号は、垂直バー、
|
です。 -
ID_columnName
とparent_columnName
の値は、同じデータ型、テキスト、または整数である必要があります。 -
parent_columnName
の値は、ID_columnName
に存在する必要があります。 つまり、子レベルで値がない場合、親を検索することはできません。 -
parent_columnName
がBLANK
場合、PATH()
はID_columnName
値を返します。 つまり、従業員のマネージャーを探しても、parent_columnName
列にデータがない場合、PATH 関数は従業員 ID のみを返します。 -
ID_columnName
に重複があり、それらの重複に対してparent_columnName
が同じである場合、PATH()
は共通のparent_columnName
値を返します。ただし、これらの重複parent_columnName
値が異なる場合、PATH()
はエラーを返します。 つまり、同じ従業員 ID に対して 2 つのリストがあり、同じマネージャー ID を持っている場合、PATH 関数はそのマネージャーの ID を返します。 ただし、マネージャー ID が異なる同一の従業員 ID が 2 つある場合、PATH 関数はエラーを返します。 -
ID_columnName
がBLANK
場合、PATH()
はBLANK
を返します。 -
ID_columnName
に垂直バー|
が含まれている場合、PATH()
はエラーを返します。
- アセンダントを区切るために使用される区切り記号は、垂直バー、
この関数は、計算列または行レベル セキュリティ (RLS) 規則で使用する場合、DirectQuery モードでは使用できません。
例
次の例では、各従業員のすべてのマネージャーを一覧表示する計算列を作成します。
= PATH(Employee[EmployeeKey], Employee[ParentEmployeeKey])