Root (MDX)

Aktualisiert: 17. Juli 2006

Gibt ein Tupel zurück, das aus den All-Elementen 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 besitzt, 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.

Hinweise

Wenn weder ein Dimensionsname noch ein Tupelausdruck angegeben wird, gibt die Root-Funktion ein Tupel zurück, das das All-Element (bzw. das Standardelement, wenn kein All-Element vorhanden ist) 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 (bzw. 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 Tuple-Funktion den Dimensionsnamen über den angegebenen Hierarchienamen aus.

Wenn ein Tupelausdruck angegeben wird, gibt die Root-Funktion ein Tupel zurück, das die Schnittmenge aus dem angegebenen Tupel und den All-Elementen aller anderen Dimensionsattribute enthält, die nicht explizit in das angegebene Tupel eingeschlossen sind. Das angegebene Tupel darf nur auf eine einzelne Dimension verweisen, andernfalls tritt ein Fehler auf.

Beispiele:

Im folgenden Beispiel wird ein Tupel zurückgegeben, der das All-Element (oder das Standardelement, wenn kein All-Element vorhanden ist) jeder Hierarchie im Adventure Works-Cube enthält.

SELECT Root()ON 0
FROM [Adventure Works]

Im folgenden Beispiel wird das Tupel zurückgegeben, das das All-Element (oder das Standardelement, wenn kein All-Element vorhanden ist) jeder Hierarchie in der Date-Dimension im Adventure Works-Cube sowie den Wert für das angegebene Element der Measure-Dimension, die sich mit diesen Standardelementen überschneidet, enthält.

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

Im folgenden Beispiel wird das Tupel zurückgegeben, das das angegebene Tupelelement (July 1, 2001 sowie das All-Element (oder das Standardelement, wenn kein All-Element vorhanden ist) jeder nicht angegebenen Hierarchie in der Date-Dimension im Adventure Works-Cube sowie den Wert für das angegebene Element der Measure-Dimension, die sich mit diesen Standardelementen überschneidet, enthält.

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

Siehe auch

Verweis

MDX-Funktionsreferenz (MDX)

Hilfe und Informationen

Informationsquellen für SQL Server 2005

Änderungsverlauf

Version	Verlauf
17. Juli 2006	Geänderter Inhalt: Syntax und Argumente wurden zur Verdeutlichung aktualisiert. Aktualisierte Beispiele wurden hinzugefügt.