CalculationPassValue (MDX)

キューブに対して指定された計算パスを評価し、多次元式 (MDX) 式の数値または文字列値を返します。

構文

  
      Numeric syntax  
CalculationPassValue(Numeric_Expression,Pass_Value [, ABSOLUTE | RELATIVE [,ALL]])  
String syntax  
CalculationPassValue(String_Expression ,Pass_Value [, ABSOLUTE | RELATIVE [,ALL]])  

引数

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

String_Expression
通常、文字列として表される数値を返すセル座標の有効な多次元式 (MDX) 式である有効な文字列式。

Pass_Value
計算パス番号を指定する有効な数値式です。

ABSOLUTE
Pass_Value パラメーターに計算パスの 0 から始まるインデックスが含まれていることを指定するアクセス フラグ値。 アクセス フラグ値が指定されていない場合は、ABSOLUTE が既定のアクセス フラグ値になります。

RELATIVE
Pass_Value パラメーターにトリガー計算の計算パスからの相対オフセットが含まれていることを指定するアクセス フラグ値。 このオフセットが 0 より小さい計算パス インデックスになる場合は、計算パス 0 が使用されます。したがって、エラーは発生しません。

ALL
このフラグを設定すると、ストレージ エンジンによって読み込まれる値を除き、すべての値が null になります。 このフラグが設定されていない場合は、何の計算も適用されずに値が集計されます。

解説

数値式が指定されると、この関数は、指定された計算パス内で指定されている (さらに、必要に応じてアクセス フラグとアクセス フラグ修飾子で修飾されている) MDX 数値式を評価し、数値を返します。

文字列式が指定されている場合、関数は、指定した計算パスで指定された MDX 文字列式を評価し、必要に応じてアクセス フラグとアクセス フラグ修飾子 * によって変更することで、文字列値を返します。*

Analysis Services の自動再帰解決では、この関数の実用的な使用はほとんど行われません。

Note

MDX スクリプト内で CalculationPassValue 関数を使用できるのは管理者だけです。 この関数を含む MDX スクリプトが、管理者権限を持たないロールのコンテキストで実行されると、エラーが発生します。

参照

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