VisualTotals (MDX)

Artikel
12/15/2008

Aktualisiert: 17. Juli 2006

Gibt eine Menge zurück, die durch dynamische Gesamtwertbildung der untergeordneten Elemente in einer angegebenen Menge generiert wird. Optional wird im Resultset ein Muster für den Namen des übergeordneten Elements verwendet.

Syntax

VisualTotals(Set_Expression[,Pattern])

Argumente

Set_Expression
Ein gültiger MDX-Ausdruck (Multidimensional Expressions), der eine Menge zurückgibt.

Pattern
Ein gültiger Zeichenfolgenausdruck für das übergeordnete Element der Menge, der ein Sternchen (*) als Ersatzzeichen für den Namen des übergeordneten Elements enthält.

Hinweise

Der angegebene Mengenausdruck kann eine Menge angeben, die Elemente auf beliebigen Ebenen innerhalb ein und derselben Dimension enthält, im Allgemeinen Elemente, die in einer Vorgänger-Nachfolger-Beziehung zueinander stehen. Die VisualTotals-Funktion fasst die Werte der untergeordneten Elemente in der angegebenen Menge zusammen. Untergeordnete Elemente, die nicht in der Menge enthalten sind, werden nicht in das Ergebnis eingeschlossen. Bei hierarchisch geordneten Mengen werden die Gesamtwerte visuell summiert. Wenn die Reihenfolge der Elemente in der Menge die Hierarchie durchbricht, werden die Ergebnisse nicht als sichtbare Gesamtwerte zurückgegeben. Beispielsweise gibt VisualTotals (USA, WA, CA, Seattle) nicht WA als Seattle zurück. Vielmehr werden die Werte für WA, CA und Seattle zurückgegeben und anschließend zum sichtbaren Gesamtwert für USA summiert, wobei die Umsätze für Seattle doppelt gezählt werden.

Hinweis:
Wird die VisualTotals-Funktion auf Dimensionselemente angewendet, die nicht mit einem Measure verknüpft sind oder unterhalb der Granularität der Measuregruppe liegen, werden die Werte durch NULL ersetzt.

Pattern, das optional ist, gibt das Format für die Bezeichnung des Gesamtwertes an. Pattern erfordert ein Sternchen (*) als Ersatzzeichen für das übergeordnete Element. Der übrige Text in der Zeichenfolge wird im Ergebnis verkettet mit dem Namen des übergeordneten Elements angezeigt. Verwenden Sie zwei Sternchen (**), um tatsächlich ein Sternchen anzuzeigen.

Beispiele:

Im folgenden Beispiel wird der sichtbare Gesamtwert für das dritte Quartal des Kalenderjahres 2001 basierend auf dem einzigen angegebenen nachfolgenden Wert, dem Monat Juli, zurückgegeben.

SELECT VisualTotals
   ({[Date].[Calendar].[Calendar Quarter].&[2001]&[3]
      ,[Date].[Calendar].[Month].&[2001]&[7]}) ON 0
FROM [Adventure Works]

Im folgenden Beispiel wird das [All]-Element der Category-Attributhierarchie in der Product-Dimension zusammen mit zwei seiner vier untergeordneten Elemente zurückgegeben. Der zurückgegebene Gesamtwert für das [All]-Element für das Internet Sales Amount-Measure stellt lediglich den Gesamtwert der Accessories- und Clothing-Elemente dar. Außerdem wird das Pattern-Argument zur Angabe der Bezeichnung für die [All Products]-Spalte verwendet.

SELECT
   VisualTotals
   ({[Product].[Category].[All Products]
      ,[Product].[Category].[Accessories]
      ,[Product].[Category].[Clothing]}
      , '* - Visual Total'
   ) ON Columns
, [Measures].[Internet Sales Amount] ON Rows
FROM [Adventure Works]

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.

Freigeben über