Ancestors (MDX)

Article
05/23/2023

Cette fonction retourne le jeu de tous les ancêtres d'un membre spécifié à un niveau ou une distance spécifiée du membre. Avec Analysis Services, l’ensemble retourné se compose toujours d’un seul membre : Analysis Services ne prend pas en charge plusieurs parents pour un seul membre.

Syntaxe

  
Level syntax  
Ancestors(Member_Expression, Level_Expression)  
  
Numeric syntax  
Ancestors(Member_Expression, Distance)

Arguments

Member_expression
Expression MDX (Multidimensional Expressions) valide qui retourne un membre.

Level_Expression
Expression MDX (Multidimensional Expressions) valide qui retourne un niveau.

Distance
Expression numérique valide qui spécifie la distance depuis le membre spécifié.

Remarques

Avec la fonction Ancêtres , vous fournissez à la fonction une expression de membre MDX, puis une expression MDX d’un niveau qui est un ancêtre de ce membre ou une expression numérique qui représente le nombre de niveaux au-dessus de ce membre. Avec ces informations, la fonction Ancêtres retourne l’ensemble de membres (qui sera un ensemble composé d’un membre) à ce niveau.

Notes

Pour retourner un membre ancêtre, plutôt qu’un jeu d’ancêtres, utilisez la fonction Ancêtre .

Si une expression de niveau est spécifiée, la fonction Ancêtres retourne l’ensemble de tous les ancêtres du membre spécifié au niveau spécifié. Si un membre spécifié n'apparaît pas dans la même hiérarchie en tant que niveau spécifié, la fonction retourne une erreur.

Si une distance est spécifiée, la fonction Ancêtres retourne l’ensemble de tous les membres qui correspondent au nombre d’étapes spécifié dans la hiérarchie spécifiée par l’expression membre. Un membre peut être spécifié en tant que membre d’une hiérarchie d’attributs, d’une hiérarchie définie par l’utilisateur ou, dans certains cas, d’une hiérarchie parent-enfant. Un nombre 1 retourne le jeu des membres au niveau parent ; un nombre 2 retourne le jeu des membres situés au niveau grand-parent (si ce niveau existe). Un nombre 0 retourne le jeu comprenant uniquement le membre lui-même.

Notes

Utilisez cette forme de la fonction Ancêtres pour les cas où le niveau du parent est inconnu ou ne peut pas être nommé.

Exemples

L’exemple suivant utilise la fonction Ancêtres pour renvoyer la mesure Internet Sales Amount pour un membre, son parent et son grand-parent. Cet exemple se base sur des expressions de niveau pour spécifier les niveaux à retourner. Les niveaux se trouvent dans la même hiérarchie que le membre spécifié dans l'expression de membre.

SELECT {  
    Ancestors([Product].[Product Categories].[Product].[Mountain-100 Silver, 38],[Product].[Product Categories].[Category]),  
    Ancestors([Product].[Product Categories].[Product].[Mountain-100 Silver, 38],[Product].[Product Categories].[Subcategory]),  
    Ancestors([Product].[Product Categories].[Product].[Mountain-100 Silver, 38],[Product].[Product Categories].[Product])  
    } ON 0,  
[Measures].[Internet Sales Amount] ON 1  
FROM [Adventure Works]

L’exemple suivant utilise la fonction Ancêtres pour renvoyer la mesure Internet Sales Amount pour un membre, son parent et son grand-parent. Cet exemple se base sur des expressions numériques pour spécifier les niveaux retournés. Les niveaux se trouvent dans la même hiérarchie que le membre spécifié dans l'expression de membre.

SELECT {  
   Ancestors(  
      [Product].[Product Categories].[Product].[Mountain-100 Silver, 38],2  
      ),  
   Ancestors(  
      [Product].[Product Categories].[Product].[Mountain-100 Silver, 38],1  
      ),  
   Ancestors(  
      [Product].[Product Categories].[Product].[Mountain-100 Silver, 38],0  
      )  
   } ON 0,  
[Measures].[Internet Sales Amount] ON 1  
FROM  [Adventure Works]

L’exemple suivant utilise la fonction Ancêtres pour renvoyer la mesure Internet Sales Amount pour le parent d’un membre d’une hiérarchie d’attributs. Cet exemple se base sur une expression numérique pour spécifier le niveau retourné. Du fait que le membre dans l'expression de membre correspond à un membre issu d'une hiérarchie d'attribut, son parent est le niveau [All].

SELECT {  
   Ancestors(  
      [Product].[Product].[Mountain-100 Silver, 38],1  
      )  
   } ON 0,  
[Measures].[Internet Sales Amount] ON 1  
FROM [Adventure Works]

Voir aussi

Guide de référence des fonctions MDX (MDX)

Partager via