CoalesceEmpty (MDX)

Wandelt einen leeren Zellwert in einen angegebenen nichtleeren Zellwert um, der entweder eine Zahl oder eine Zeichenkette sein kann.

Syntax

  
Numeric syntax  
CoalesceEmpty( Numeric_Expression1 [ ,Numeric_Expression2,...n] )  
  
String syntax  
CoalesceEmpty(String_Expression1 [ ,String_Expression2,...n] )  

Argumente

Numeric_Expression1
Ein gültiger numerischer Ausdruck, der typischerweise ein Multidimensional Expressions (MDX)-Ausdruck von Zellkoordinaten ist, die eine Zahl zurückgeben.

Numeric_Expression2
Ein gültiger numerischer Ausdruck, der typischerweise ein angegebener numerischer Wert ist.

String_Expression1
Ein gültiger String-Ausdruck, der typischerweise ein Multidimensional Expressions (MDX)-Ausdruck von Zellkoordinaten ist und einen String zurückgibt.

String_Expression2
Ein gültiger Zeichenkettenausdruck, der typischerweise ein spezifizierter Zeichenkettenwert ist, der durch den ersten Zeichenkettenausdruck zurückgegeben wird, wird durch einen NULL ersetzt.

Bemerkungen

Wenn ein oder mehrere numerische Ausdrücke angegeben sind, gibt die CoalesceEmpty-Funktion den numerischen Wert des ersten numerischen Ausdrucks (von links nach rechts) zurück, der zu einem nichtleeren Wert aufgelöst werden kann. Wenn keiner der spezifizierten numerischen Ausdrücke auf einen nichtleeren Wert aufgelöst werden kann, gibt die Funktion den leeren Zellwert zurück. Typischerweise ist der Wert für den zweiten numerischen Ausdruck der numerische Wert, der für einen NULL ersetzt wird, der durch den ersten numerischen Ausdruck zurückgegeben wird.

Wenn ein oder mehrere Zeichenkettenausdrücke angegeben sind, gibt die Funktion den Zeichenzeichenwert des ersten Zeichenzeichenausdrucks (von links nach rechts) zurück, der auf einen nichtleeren Wert aufgelöst werden kann. Wenn keine der angegebenen Zeichenkettenausdrücke auf einen nichtleeren Wert aufgelöst werden kann, gibt die Funktion den leeren Zellwert zurück. Typischerweise ist der Wert für den zweiten String-Ausdruck der String-Wert, der durch einen NULL ersetzt wird, der vom ersten String-Ausdruck zurückgegeben wird.

Die CoalesceEmpty-Funktion kann nur Werte desselben Typs annehmen. Mit anderen Worten: Alle spezifizierten Wertausdrücke müssen nur auf numerische Datentypen oder einen leeren Zellwert auswerten, oder alle angegebenen Wertausdrücke müssen auf String-Datentypen oder auf einen leeren Zellwert auswerten. Ein einziger Aufruf dieser Funktion kann nicht sowohl numerische als auch String-Ausdrücke enthalten.

Weitere Informationen zu leeren Zellen finden Sie in der OLE DB-Dokumentation.

Example

Das folgende Beispiel fragt den Adventure Works-Würfel ab. Dieses Beispiel liefert die Bestellmenge jedes Produkts und den Prozentsatz der Bestellmengen nach Kategorie zurück. Die CoalesceEmpty-Funktion stellt sicher, dass Nullwerte bei der Formatierung der berechneten Elemente als null (0) dargestellt werden.

WITH   
   MEMBER [Measures].[Order Percent by Category] AS  
   CoalesceEmpty(   
      ([Product].[Product Categories].CurrentMember,  
        Measures.[Order Quantity]) /   
          (  
           Ancestor  
           ( [Product].[Product Categories].CurrentMember,   
             [Product].[Product Categories].[Category]  
           ), Measures.[Order Quantity]  
       ), 0  
   ), FORMAT_STRING='Percent'  
SELECT   
   {Measures.[Order Quantity],  
      [Measures].[Order Percent by Category]} ON COLUMNS,  
{[Product].[Product].Members} ON ROWS  
FROM [Adventure Works]  
WHERE {[Date].[Calendar Year].[Calendar Year].&[2003]}  

Verwandte Inhalte

• MDX-Funktionsreferenz (MDX)