Ancestors (MDX)Ancestors (MDX)

SI APPLICA A:sìSQL Server Analysis ServicesnoAzure Analysis ServicesAPPLIES TO:yesSQL Server Analysis ServicesnoAzure Analysis Services

Funzione che restituisce il set di tutti i predecessori di un membro specificato al livello specificato oppure alla distanza specificata dal membro.A function that returns the set of all ancestors of a specified member at a specified level or at a specified distance from the member. Con MicrosoftMicrosoft SQL ServerSQL Server Analysis ServicesAnalysis Services, il set restituito sarà sempre costituito da un singolo membro, Analysis ServicesAnalysis Services non supporta più elementi padre per un singolo membro.With MicrosoftMicrosoft SQL ServerSQL Server Analysis ServicesAnalysis Services, the set returned will always consist of a single member - Analysis ServicesAnalysis Services does not support multiple parents for a single member.

SintassiSyntax


Level syntax  
Ancestors(Member_Expression, Level_Expression)  

Numeric syntax  
Ancestors(Member_Expression, Distance)  

ArgomentiArguments

Member_ExpressionMember_Expression
Espressione MDX (Multidimensional Expression) valida che restituisce un membro.A valid Multidimensional Expressions (MDX) expression that returns a member.

Level_ExpressionLevel_Expression
Espressione MDX (Multidimensional Expression) valida che restituisce un livello.A valid Multidimensional Expressions (MDX) expression that returns a level.

DistanzaDistance
Espressione numerica valida che specifica la distanza dal membro specificato.A valid numeric expression that specifies the distance from the specified member.

OsservazioniRemarks

Con il predecessori funzione, si specifica la funzione con un'espressione di membro MDX e quindi un'espressione MDX di un livello è un predecessore di tale membro oppure un'espressione numerica che rappresenta il numero di livelli di sopra di tale membro.With the Ancestors function, you provide the function with an MDX member expression and then provide either an MDX expression of a level that is an ancestor of that member or a numeric expression that represents the number of levels above that member. Con queste informazioni, il predecessori funzione restituisce il set di membri (che sarà un set costituito da un membro) a tale livello.With this information, the Ancestors function returns the set of members (which will be a set consisting of one member) at that level.

Nota

Per restituire un membro predecessore, anziché un set di predecessori, utilizza il predecessore (funzione).To return an ancestor member, rather than an ancestor set, use the Ancestor function.

Se si specifica un'espressione di livello il predecessori funzione restituisce il set di tutti i predecessori del membro specificato al livello specificato.If a level expression is specified, the Ancestors function returns the set of all ancestors of the specified member at the specified level. Se il membro specificato non è incluso nella stessa gerarchia del livello specificato, la funzione restituisce un errore.If the specified member is not within the same hierarchy as the specified level, the function returns an error.

Se viene specificata una distanza, la predecessori funzione restituisce il set di tutti i membri che sono il numero di passaggi specificato nella gerarchia specificata dall'espressione di membro.If a distance is specified, the Ancestors function returns the set of all members that are the number of steps specified up in the hierarchy specified by the member expression. Un membro può essere specificato come membro di una gerarchia dell'attributo, una gerarchia definita dall'utente o, in alcuni casi, una gerarchia padre-figlio.A member may be specified as a member of an attribute hierarchy, a user-defined hierarchy, or, in some cases, a parent-child hierarchy. Con il numero 1 viene restituito il set di membri al livello padre, mentre con il numero 2 viene restituito il set di membri al livello dell'elemento padre del padre, se esistente.A number of 1 returns the set of members at the parent level and a number of 2 returns the set of members at the grandparent level (if one exists). Il numero 0 restituisce il set contenente soltanto il membro stesso.A number of 0 returns the set including only the member itself.

Nota

Utilizzare questo modulo del predecessori funzione per i casi in cui il livello dell'elemento padre è sconosciuto o non può essere rinominato.Use this form of the Ancestors function for cases in which the level of the parent is unknown or cannot be named.

EsempiExamples

L'esempio seguente usa il predecessori funzione per restituire la misura Internet Sales Amount per un membro padre e il relativo elemento padre del padre.The following example uses the Ancestors function to return the Internet Sales Amount measure for a member, its parent, and its grandparent. Nell'esempio vengono utilizzate espressioni di livello per specificare i livelli da restituire.This example uses level expressions to specify the levels to be returned. I livelli sono contenuti nella stessa gerarchia del membro specificato nell'espressione di membro.The levels are in the same hierarchy as the member specified in the member expression.

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'esempio seguente usa il predecessori funzione per restituire la misura Internet Sales Amount per un membro padre e il relativo elemento padre del padre.The following example uses the Ancestors function to return the Internet Sales Amount measure for a member, its parent, and its grandparent. Nell'esempio vengono utilizzate espressioni numeriche per specificare i livelli restituiti.This example uses numeric expressions to specify the levels being returned. I livelli sono contenuti nella stessa gerarchia del membro specificato nell'espressione di membro.The levels are in the same hierarchy as the member specified in the member expression.

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'esempio seguente usa il predecessori funzione per restituire la misura Internet Sales Amount per l'elemento padre di un membro di una gerarchia dell'attributo.The following example uses the Ancestors function to return the Internet Sales Amount measure for the parent of a member of an attribute hierarchy. Nell'esempio viene utilizzata un'espressione numerica per specificare il livello restituito.This example uses a numeric expression to specify the level being returned. Poiché il membro dell'espressione di membro è membro di una gerarchia dell'attributo, il relativo elemento padre è costituito dal livello [Totale].Since the member in the member expression is a member of an attribute hierarchy, its parent is the [All] level.

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

Vedere ancheSee Also

Riferimento alla funzione MDX ( MDX )MDX Function Reference (MDX)