CoalesceEmpty (MDX)

Převede prázdnou hodnotu buňky na určenou hodnotu neprázdné buňky, která může být buď číslem, nebo řetězcem.

Syntax

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

Arguments

Numeric_Expression1
Platný číselný výraz, který je typicky výrazem Multidimenzionálních výrazů (MDX) souřadnic buňky, které vracejí číslo.

Numeric_Expression2
Platný číselný výraz, který je obvykle určenou číselnou hodnotou.

String_Expression1
Platný řetězcový výraz, který je typicky výrazem Multidimensional Expressions (MDX) souřadnic buňky a vrací řetězec.

String_Expression2
Platný řetězcový výraz, který je obvykle specifikovanou hodnotou řetězce nahrazenou NULL vráceným prvním řetězcovým výrazem.

Remarks

Pokud je zadán jeden nebo více číselných výrazů, funkce CoalesceEmpty vrátí číselnou hodnotu prvního číselného výrazu (zleva doprava), který lze rozlišit na neprázdnou hodnotu. Pokud žádný z daných číselných výrazů nelze vyřešit na neprázdnou hodnotu, funkce vrátí prázdnou hodnotu buňky. Obvykle je hodnota druhého číselného výrazu číselnou hodnotou, která je nahrazena NULL vráceným prvním číselným výrazem.

Pokud je zadán jeden nebo více řetězcových výrazů, funkce vrátí hodnotu řetězce prvního řetězcového výrazu (zleva doprava), kterou lze vyřešit na neprázdnou hodnotu. Pokud žádný ze specifikovaných řetězcových výrazů nelze vyřešit na neprázdnou hodnotu, funkce vrátí prázdnou hodnotu buňky. Typicky je hodnota druhého řetězcového výrazu ta řetězec, která je nahrazena NULL vráceným prvním řetězcovým výrazem.

Funkce CoalesceEmpty může přijímat pouze hodnoty stejného typu. Jinými slovy, všechny specifikované hodnotové výrazy musí vyhodnotit pouze na číselné datové typy nebo prázdnou hodnotu buňky, nebo všechny specifikované hodnotové výrazy musí být vyčísleny do řetězcových datových typů nebo do prázdné buňky. Jedno volání této funkce nemůže zahrnovat zároveň číselné i řetězcové výrazy.

Pro více informací o prázdných buňkách viz dokumentaci OLE DB.

Example

Následující příklad se ptá na Adventure Works krychle. Tento příklad vrací množství objednávek každého produktu a procento objednávek podle kategorií. Funkce CoalesceEmpty zajišťuje, že nulové hodnoty jsou při formátování vypočítáných členů reprezentovány jako nula (0).

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

Související obsah

• Referenční informace k funkcím MDX (MDX)