Root (MDX)

Artikel
05/23/2023

Gibt ein Tupel zurück, das aus den Elementen Alle aus jeder Attributhierarchie innerhalb des aktuellen Bereichs in einem Cube, einer Dimension oder einem Tupel besteht. Weitere Informationen zum Bereich finden Sie unter SCOPE-Anweisung (MDX).

Hinweis

Wenn eine Attributhierarchie kein All-Element aufweist, enthält das Tupel das Standardelement für diese Hierarchie.

Syntax

  
Cube syntax  
Root ()  
Dimension syntax  
Root( Dimension_Name )  
Tuple syntax  
Root( Tuple_Expression )

Argumente

Dimension_Name
Ein gültiger Zeichenfolgenausdruck, der einen Dimensionsnamen angibt.

Tuple_Expression
Ein gültiger MDX-Ausdruck (Multidimensional Expressions), der ein Tupel zurückgibt.

Bemerkungen

Wenn weder ein Dimensionsname noch ein Tupelausdruck angegeben wird, gibt die Root-Funktion ein Tupel zurück, das das Element "Alle " (oder das Standardelement, wenn das Element "Alle " nicht vorhanden ist) aus jeder Attributhierarchie im Cube enthält. Die Reihenfolge der Elemente im Tupel basiert auf der Reihenfolge, in der die Attributhierarchien innerhalb des Cubes definiert sind.

Wenn ein Dimensionsname angegeben wird, gibt die Root-Funktion ein Tupel zurück, das das All-Element (oder das Standardelement, wenn das All-Element nicht vorhanden ist) aus jeder Attributhierarchie in der angegebenen Dimension basierend auf dem Kontext des aktuellen Elements enthält. Die Reihenfolge der Elemente im Tupel basiert auf der Reihenfolge, in der die Attributhierarchien innerhalb der Dimension definiert sind.

Hinweis

Wenn ein Hierarchiename angegeben wird, wählt die Tupelfunktion den Dimensionsnamen aus dem angegebenen Hierarchienamen aus.

Wenn ein Tupelausdruck angegeben wird, gibt die Root-Funktion ein Tupel zurück, das die Schnittmenge des angegebenen Tupels und die Alle-Member aller anderen Dimensionsattribute enthält, die nicht explizit im angegebenen Tupel enthalten sind.

Beispiele

SELECT Root()ON 0  
FROM [Adventure Works]

Im folgenden Beispiel wird das Tupel zurückgegeben, das das Element "Alle " (oder den Standardwert, wenn das Element "Alle " nicht vorhanden ist) aus jeder Hierarchie in der Date-Dimension im Adventure Works-Cube und den Wert für das angegebene Element der Measures-Dimension zurück, das sich mit diesen Standardmembern überschneidet.

SELECT Root([Date]) ON 0  
FROM [Adventure Works]  
WHERE [Measures].[Order Count]

Im folgenden Beispiel wird das Tupel zurückgegeben, das das angegebene Tupelelement (1. Juli 2001) zusammen mit dem Element "All " (oder dem Standardwert, wenn das Element "Alle " nicht vorhanden ist) aus jeder nicht angegebenen Hierarchie im Adventure Works-Cube der Datumsdimension und den Wert für das angegebene Element der Measures-Dimension zurück, das sich mit diesen Elementen überschneidet.

SELECT Root([Date].[July 1, 2001]) ON 0  
FROM [Adventure Works]  
WHERE [Measures].[Order Count]

Weitere Informationen

MDX-Funktionsreferenz (MDX)