Partager via

Fonction PATH (DAX)

  • Article

Retourne une chaîne de texte délimitée avec les identificateurs de tous les parents de l'identificateur actuel, depuis l'élément le plus ancien jusqu'à l'élément actuel.

Syntaxe

PATH(<ID_columnName>, <parent_columnName>)

Paramètres

  • ID_columnName
    Nom d'une colonne existante qui contient l'identificateur unique des lignes de la table. Il ne peut pas s'agir d'une expression. Le type de données de la valeur dans ID_columnName doit être texte ou entier, et doit correspondre également au même type de données que celui de la colonne référencée dans parent_columnName.

  • parent_columnName
    Nom d'une colonne existante qui contient l'identificateur unique du parent de la ligne actuelle. Il ne peut pas s'agir d'une expression. Le type de données de la valeur dans le type de données parent_columnName doit être texte ou entier, et doit correspondre au même type de données que celui de la valeur dans ID_columnName.

Valeur de retour

Chaîne de texte délimitée qui contient les identificateurs de tous les parents de l'identificateur actuel.

Notes

Cette fonction est utilisée dans les tables qui ont une sorte de hiérarchie interne, afin de retourner les éléments associés à la valeur de ligne actuelle. Par exemple, dans une table Employees qui contient des employés, les responsables des employés et les responsables des responsables, vous pouvez retourner la relation hiérarchique qui unit un employé à son responsable.

La relation hiérarchique ne se limite pas à un seul niveau de relations parent-enfant ; il est possible de retourner des lignes associées qui se trouvent plusieurs niveaux au-dessus de la ligne initiale spécifiée.

  • Le délimiteur utilisé pour séparer les ascendants est la barre verticale, « | ».

  • Les valeurs dans ID_columnName et parent_columnName doivent avoir le même type de données, texte ou entier.

  • Les valeurs dans parent_columnName doivent être présentes dans ID_columnName. En d'autres termes, vous ne pouvez pas rechercher un parent s'il n'existe aucune valeur au niveau enfant.

  • Si parent_columnName est BLANK, PATH() retourne la valeur ID_columnName. En d'autres termes, si vous recherchez le responsable d'un employé alors que la colonne parent_columnName n'a pas de données, la fonction PATH retourne juste l'ID de l'employé.

  • Si ID_columnName a des doublons et si parent_columnName est identique pour ces doublons, PATH() retourne la valeur de parent_columnName commune ; toutefois, si la valeur de parent_columnName est différente pour ces doublons, PATH() retourne une erreur. En d'autres termes, si vous avez deux enregistrements pour le même ID d'employé et s'ils ont le même ID de responsable, la fonction PATH retourne l'ID de ce responsable. Toutefois, s'il existe deux ID d'employés identiques avec des ID de responsables différents, la fonction PATH retourne une erreur.

  • Si ID_columnName est BLANK, PATH() retourne BLANK.

  • Si ID_columnName contient une barre verticale « | », PATH() retourne une erreur.

Cette fonction DAX n'est pas prise en charge en mode DirectQuery. Pour plus d'informations sur les limitations dans les modèles DirectQuery, consultez https://go.microsoft.com/fwlink/?LinkId=219172.

Exemple

L'exemple suivant crée une colonne calculée qui répertorie tous les responsables de chaque employé.

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