IIf (MDX)
ブール条件が true か false かに応じて、異なる分岐の式を評価します。
構文
IIf(Logical_Expression, Expression1 [HINT <hints>], Expression2 [HINT <hints>])
引数
IIf 関数は、iif(<condition, then branch, <<else branch>>) の 3 つの引数を受け取>ります。
Logical_Expression
true (1) または false (0) に評価される条件。 有効な多次元式 (MDX) の論理式を指定する必要があります。
Expression1 Hint [Eager|Strict|Lazy]]
論理式が true と評価されるときに使用されます。 Expression1 は、有効な多次元式 (MDX) 式である必要があります。
Expression2 ヒント [Eager|Strict|Lazy]]
論理式が false と評価されるときに使用 されます。 Expression2 には、有効な多次元式 (MDX) を指定する必要があります。
解説
論理式で指定された条件は、この式の値が 0 の場合に false に 評価されます。 その他の値は true に評価 されます。
条件が true の場合、 IIf 関数は最初の式を返します。 それ以外の場合、関数は 2 番目の式を返します。
指定した式は、値または MDX オブジェクトを返すことができます。 また、1 番目と 2 番目の式の型は一致しなくてもかまいません。
検索条件に基づいてメンバーのセットを作成する場合、 IIf 関数はお勧めしません。 代わりに、 Filter 関数を使用して、指定したセット内の各メンバーを論理式に対して評価し、メンバーのサブセットを返します。
Note
いずれかの式が NULL と評価された場合、その条件が満たされたときに結果セットは NULL になります。
Hint は、式の評価方法とタイミングを決定する省略可能な修飾子です。 これにより、式の評価方法を指定することで、既定のクエリ プランをオーバーライドできます。
EAGER は、元の IIF サブスペースに対して式を評価します。
STRICT を指定すると、論理条件式によって作成された制限付きのサブ空間のみで式が評価されます。
LAZY は、セル単位モードで式を評価します。
EAGER と STRICT は IIF の then-else ブランチにのみ適用されますが、LAZY はすべての MDX 式に適用されます。 任意の MDX 式の後に HINT LAZY を指定すると、セル単位モードでその式が評価されます。
ヒントでは、EAGER と STRICT は相互に排他的です。これらは、異なる式に対して同じ IIF(,,) で使用できます。
詳細については、「SQL Server Analysis Services 2008 の IIF 関数クエリ ヒント」および「MDX IIF 関数と CASE ステートメントの実行プランとプラン ヒント」を参照してください。
例
次のクエリは、Internet Sales Amount が $10000 より大きいか小さい場合に 2 つの異なる文字列値のいずれかを返す、計算メジャー内での IIF の簡単な使用を示しています。
WITH MEMBER MEASURES.IIFDEMO AS
IIF([Measures].[Internet Sales Amount]>10000
, "Sales Are High", "Sales Are Low")
SELECT {[Measures].[Internet Sales Amount],MEASURES.IIFDEMO} ON 0,
[Date].[Date].[Date].MEMBERS ON 1
FROM [Adventure Works]
IIF の非常に一般的な用途は、次の例のように、計算されるメジャー内で "ゼロによる除算" エラーを処理する方法です。
WITH
//Returns 1.#INF when the previous period contains no value
//but the current period does
MEMBER MEASURES.[Previous Period Growth With Errors] AS
([Measures].[Internet Sales Amount]-([Measures].[Internet Sales Amount], [Date].[Date].CURRENTMEMBER.PREVMEMBER))
/
([Measures].[Internet Sales Amount], [Date].[Date].CURRENTMEMBER.PREVMEMBER)
,FORMAT_STRING='PERCENT'
//Traps division by zero and returns null when the previous period contains
//no value but the current period does
MEMBER MEASURES.[Previous Period Growth] AS
IIF(([Measures].[Internet Sales Amount], [Date].[Date].CURRENTMEMBER.PREVMEMBER)=0,
NULL,
([Measures].[Internet Sales Amount]-([Measures].[Internet Sales Amount], [Date].[Date].CURRENTMEMBER.PREVMEMBER))
/
([Measures].[Internet Sales Amount], [Date].[Date].CURRENTMEMBER.PREVMEMBER)
),FORMAT_STRING='PERCENT'
SELECT {[Measures].[Internet Sales Amount],MEASURES.[Previous Period Growth With Errors], MEASURES.[Previous Period Growth]} ON 0,
DESCENDANTS(
[Date].[Calendar].[Calendar Year].&[2004],
[Date].[Calendar].[Date])
ON 1
FROM [Adventure Works]
WHERE([Product].[Product Categories].[Subcategory].&[26])
次の例は、 IIF が Generate 関数内の 2 つのセットのいずれかを返して、Rows に組の複雑なセットを作成する例です。
SELECT {[Measures].[Internet Sales Amount]} ON 0,
//If Internet Sales Amount is zero or null
//returns the current year and the All Customers member
//else returns the current year broken down by Country
GENERATE(
[Date].[Calendar Year].[Calendar Year].MEMBERS
, IIF([Measures].[Internet Sales Amount]=0,
{([Date].[Calendar Year].CURRENTMEMBER, [Customer].[Country].[All Customers])}
, {{[Date].[Calendar Year].CURRENTMEMBER} * [Customer].[Country].[Country].MEMBERS}
))
ON 1
FROM [Adventure Works]
WHERE([Product].[Product Categories].[Subcategory].&[26])
最後に、次の例では、プラン ヒントの使用方法を示します。
WITH MEMBER MEASURES.X AS
IIF(
[Measures].[Internet Sales Amount]=0
, NULL
, (1/[Measures].[Internet Sales Amount]) HINT EAGER)
SELECT {[Measures].x} ON 0,
[Customer].[Customer Geography].[Country].MEMBERS ON 1
FROM [Adventure Works]