CoalesceEmpty (MDX)

空のセル値を指定した空のセル値に変換します。値は数値または文字列のいずれかになります。

構文

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

引数

Numeric_Expression1
通常、数値を返すセル座標の多次元式 (MDX) 式である有効な数値式。

Numeric_Expression2
通常、指定された数値である有効な数値式。

String_Expression1
有効な文字列式です。通常は、文字列を返すセル座標の多次元式 (MDX) 式です。

String_Expression2
通常、最初の文字列式によって返される NULL に置き換わる指定された文字列値である有効な文字列式。

解説

1 つ以上の数値式が指定されている場合、 CoalesceEmpty 関数は、空でない値に解決できる最初の数値式 (左から右) の数値を返します。 指定されている数値式に、空でない値に解決される式がない場合、この関数は、空のセル値を返します。 通常、2 番目の数値式の値は、最初の数値式によって返される NULL に置き換わる数値です。

1 つ以上の文字列式が指定されている場合、関数は、空でない値に解決できる最初の文字列式の文字列値 (左から右) を返します。 指定した文字列式を空でない値に解決できない場合、関数は空のセル値を返します。 通常、2 番目の文字列式の値は、最初の文字列式によって返される NULL に置き換わる文字列値です。

CoalesceEmpty 関数は、同じ型の値のみを受け取ることができます。 つまり、指定した値式は、すべて 1 つの数値データ型または空のセル値に評価されるか、すべて 1 つの文字列データ型または空のセル値に評価される必要があります。 この関数の 1 回の呼び出しで、数値式と文字列式を両方含めることはできません。

空のセルの詳細については、OLE DB のドキュメントを参照してください。

例

次の例では、 Adventure Works キューブに対してクエリを実行します。 次の使用例は、各製品の注文数量と、カテゴリ別の注文数量の割合を返します。 CoalesceEmpty 関数を使用すると、計算されるメンバーを書式設定するときに null 値が 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]}  

参照

MDX 関数リファレンス (MDX)