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