Функция PATH (DAX)

Возвращает строку текста с разделителями, содержащую идентификаторы всех родительских элементов текущего идентификатора, с самого старого до текущего.

Синтаксис

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 является пустым, функция PATH() возвращает значение ID_columnName. Другими словами, если при поиске менеджера сотрудника в столбце parent_columnName нет соответствующих сведений, функция PATH возвращает идентификатор сотрудника.

  • Если столбец ID_columnName содержит повторы, а значение parent_columnName одинаково для таких повторов, функция PATH() возвращает общее значение parent_columnName. Тем не менее, если значение parent_columnName отлично для повторов, функция PATH() возвращает ошибку. Другими словами, при наличии двух списков для одного и того же идентификатора сотрудника с одним идентификатором менеджера функция PATH возвращает идентификатор этого менеджера. Однако, если имеются два сотрудника с одинаковым идентификатором, имеющие разные идентификаторы менеджеров, функция PATH возвращает ошибку.

  • Если значение ID_columnName является пустым, функция PATH() возвращает пустое значение.

  • Если значение ID_columnName содержит вертикальную черту «|», функция PATH() возвращает ошибку.

Использование этой функции DAX в режиме DirectQuery не поддерживается. Дополнительные сведения об ограничениях моделей в режиме DirectQuery см. по ссылке https://go.microsoft.com/fwlink/?LinkId=219172.

Пример

В следующем примере создается вычисляемый столбец, содержащий список всех менеджеров каждого сотрудника.

=PATH(Employee[EmployeeKey], Employee[ParentEmployeeKey])