Ancestors (MDX)
Eine Funktion, die die Menge aller Vorgänger eines angegebenen Elements in einer angegebenen Ebene oder in einem angegebenen Abstand vom Element zurückgibt. Bei Analysis Services besteht der zurückgegebene Satz immer aus einem einzelnen Member. Analysis Services unterstützt nicht mehrere übergeordnete Elemente für ein einzelnes Element.
Syntax
Level syntax
Ancestors(Member_Expression, Level_Expression)
Numeric syntax
Ancestors(Member_Expression, Distance)
Argumente
Member_Expression
Ein gültiger MDX-Ausdruck (Multidimensional Expressions), der ein Element zurückgibt.
Level_Expression
Ein gültiger MDX-Ausdruck (Multidimensional Expressions), der eine Ebene zurückgibt.
Entfernung
Ein gültiger numerischer Ausdruck, der den Abstand vom angegebenen Element angibt.
Bemerkungen
Mit der Funktion Ancestors stellen Sie die Funktion mit einem MDX-Memberausdruck bereit und geben dann entweder einen MDX-Ausdruck einer Ebene an, die ein Vorgänger dieses Members ist, oder einen numerischen Ausdruck, der die Anzahl der Ebenen oberhalb dieses Elements darstellt. Mit diesen Informationen gibt die Ancestors-Funktion den Satz von Membern (eine Gruppe, die aus einem Member besteht) auf dieser Ebene zurück.
Hinweis
Verwenden Sie die Funktion Vorgänger , um ein Vorgängerelement anstelle einer Vorgängermenge zurückzugeben.
Wenn ein Ebenenausdruck angegeben wird, gibt die Ancestors-Funktion den Satz aller Vorgänger des angegebenen Elements auf der angegebenen Ebene zurück. Wenn sich der angegebene Member nicht in derselben Hierarchie wie die angegebene Ebene befindet, gibt die Funktion einen Fehler zurück.
Wenn ein Abstand angegeben wird, gibt die Ancestors-Funktion den Satz aller Member zurück, die die Anzahl der Schritte sind, die in der vom Memberausdruck angegebenen Hierarchie angegeben sind. Ein Element kann als Mitglied einer Attributhierarchie, einer benutzerdefinierten Hierarchie oder in einigen Fällen als Über-/Unterordnungshierarchie angegeben werden. 1 gibt die Menge der Elemente auf der übergeordneten Ebene und 2 die Menge der Elemente auf der dieser Ebene übergeordneten Ebene (sofern vorhanden) zurück. 0 gibt die Menge zurück, die nur das Element selbst enthält.
Hinweis
Verwenden Sie diese Form der Ancestors-Funktion für Fälle, in denen die Ebene des übergeordneten Elements unbekannt ist oder nicht benannt werden kann.
Beispiele
Im folgenden Beispiel wird die Ancestors-Funktion verwendet, um das Measure Internet Sales Amount für ein Element, dessen übergeordnetes Element und dessen Großeltern zurückzugeben. In diesem Beispiel werden Ebenenausdrücke zum Angeben der zurückzugebenden Ebene verwendet. Die Ebenen befinden sich in der gleichen Hierarchie wie das im Elementausdruck angegebene Element.
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]
Im folgenden Beispiel wird die Ancestors-Funktion verwendet, um das Measure Internet Sales Amount für ein Element, dessen übergeordnetes Element und dessen Großeltern zurückzugeben. In diesem Beispiel werden numerische Ausdrücke zum Angeben der zurückzugebenden Ebene verwendet. Die Ebenen befinden sich in der gleichen Hierarchie wie das im Elementausdruck angegebene Element.
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]
Im folgenden Beispiel wird die Ancestors-Funktion verwendet, um das Internet Sales Amount-Measure für das übergeordnete Element eines Elements einer Attributhierarchie zurückzugeben. In diesem Beispiel wird ein numerischer Ausdruck zum Angeben der zurückzugebenden Ebene verwendet. Da das Element im Elementausdruck ein Element einer Attributhierarchie darstellt, ist das ihm übergeordnete Element die [All]-Ebene.
SELECT {
Ancestors(
[Product].[Product].[Mountain-100 Silver, 38],1
)
} ON 0,
[Measures].[Internet Sales Amount] ON 1
FROM [Adventure Works]