CoalesceEmpty (MDX)

Omvandlar ett tomt cellvärde till ett specificerat icke-tomt cellvärde, vilket kan vara antingen ett tal eller en sträng.

Syntax

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

Arguments

Numeric_Expression1
Ett giltigt numeriskt uttryck som vanligtvis är ett Multidimensional Expressions (MDX)-uttryck av cellkoordinater som returnerar ett tal.

Numeric_Expression2
Ett giltigt numeriskt uttryck som vanligtvis är ett specificerat numeriskt värde.

String_Expression1
Ett giltigt stränguttryck som vanligtvis är ett Multidimensional Expressions (MDX)-uttryck av cellkoordinater som returnerar en sträng.

String_Expression2
Ett giltigt stränguttryck som vanligtvis är ett specificerat strängvärde och ersätter ett NULL som returneras av det första stränguttrycket.

Remarks

Om ett eller flera numeriska uttryck specificeras, returnerar CoalesceEmpty-funktionen det numeriska värdet för det första numeriska uttrycket (från vänster till höger) som kan lösas till ett icke-tomt värde. Om inget av de specificerade numeriska uttrycken kan lösas till ett icke-tomt värde, returnerar funktionen det tomma cellvärdet. Vanligtvis är värdet för det andra numeriska uttrycket det numeriska värdet som ersätter en NULL som returneras av det första numeriska uttrycket.

Om ett eller flera stränguttryck specificeras, returnerar funktionen strängvärdet för det första stränguttrycket (från vänster till höger) som kan lösas till ett icke-tomt värde. Om ingen av de specificerade stränguttrycken kan lösas till ett icke-tomt värde, returnerar funktionen det tomma cellvärdet. Vanligtvis är värdet för det andra stränguttrycket det strängvärde som ersätter ett NULL som returneras av det första stränguttrycket.

Funktionen CoalesceEmpty kan endast ta värden av samma typ. Med andra ord måste alla specificerade värdeuttryck utvärdera till endast numeriska datatyper eller ett tomt cellvärde, eller så måste alla specificerade värdeuttryck utvärderas till strängdatatyper eller till ett tomt cellvärde. Ett enda anrop till denna funktion kan inte inkludera både numeriska och stränguttryck.

För mer information om tomma celler, se OLE DB-dokumentationen.

Example

Följande exempel frågar Adventure Works-kuben . Detta exempel returnerar orderkvantiteten för varje produkt och procentandelen orderkvantiteter per kategori. Funktionen CoalesceEmpty säkerställer att nollvärden representeras som noll (0) när de beräknade elementen formateras.

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]}  

Relaterat innehåll

• Referens för MDX-funktioner (MDX)