CalculationPassValue (MDX)

更新 : 2006 年 7 月 17 日

キューブに対して指定された計算パスを評価し、多次元式 (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
  計算パスのインデックス (0 ベース) が Pass_Value パラメータに格納されていることを指定するアクセス フラグ値です。アクセス フラグ値が指定されていない場合は、ABSOLUTE が既定のアクセス フラグ値になります。

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

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

解説

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

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

Microsoft SQL Server 2000 Analysis Services では、再帰の問題を処理する際に、この関数を IIf (MDX) および CalculationCurrentPass (MDX) と組み合わせて使用します。ただし、SQL Server 2005 Analysis Services では再帰が自動的に解決されるため、この関数の実用性はほとんどありません。

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

参照

関連項目

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

ヘルプおよび情報

SQL Server 2005 の参考資料の入手

変更履歴