ToggleDrillState (MDX)

ドリルダウン モードとドリルアップ モードの間で、メンバーのドリル状態を切り替えます。

構文

  
ToggleDrillState(Set_Expression1,Set_Expression2 [, [RECURSIVE] [,INCLUDE_CALC_MEMBERS] ] )  

引数

Set_Expression1
セットを返す有効な多次元式 (MDX) 式。

Set_Expression2
セットを返す有効な多次元式 (MDX) 式。

再帰
(省略可能)。 セットの再帰的な比較を示すキーワードです。 ToggleDrillState 関数は、DrillupMember 関数と DrilldownMember 関数の組み合わせです。 再帰は、メンバーが DrilldownMember 状態の場合にのみ適用されます。

Include_calc_members
(省略可能)。 計算されるメンバーがドリルダウン レベルに存在する場合にそれらを含めるかどうかを示すフラグです。

解説

ToggleDrillState 関数は、最初のセットに存在する 2 番目のセットの各メンバーのドリル状態を切り替えます。 最初のセットには任意の次元のタプルを含めることができますが、2 番目のセットには 1 つのディメンションのメンバーを含める必要があります。 ToggleDrillState 関数は、DrillupMember 関数と DrilldownMember 関数の組み合わせです。 2 番目のセットのメンバー m が最初のセットに存在し、そのメンバーがドリルダウンされた場合 (つまり、その直後に子孫がある) 場合 DrillupMember(Set_Expression1, {m}) は、最初のセットのメンバーまたはタプルに適用されます。 その m メンバーがドリルアップされた場合 (つまり、m の直後に m の子孫が存在しない) DrilldownMember(Set_Expression1, {m}[, RECURSIVE]) は、最初のセットに適用されます。

省略可能な RECURSIVE フラグを使用する場合は、ドリルアップとドリルダウンが再帰的に適用されます。 再帰フラグの詳細については、DrillupMember 関数と DrilldownMember 関数を参照してください。

XMLA プロパティ MdpropMdxDrillFunctions のクエリを実行すると、サーバーがドリル関数に対して提供するサポート レベルを確認できます。詳細については、「 サポートされている XMLA プロパティ (XMLA)」 を参照してください。

この関数に関連するシナリオと例については、「 データベース ジャーナル: MDX セット関数: ToggleDrillState() 関数」を参照してください。

例

次の例では、最初のセットの Australia メンバーをドリルダウンし、最初のセットの 米国 メンバーをドリルアップします。

SELECT ToggleDrillState  
   ({[Geography].[Geography].[Country].Members, [Geography].[Geography].[Country].&[United States].Children},  
      {[Geography].[Geography].[Country].[Australia]  
      , [Geography].[Geography].[Country].&[United States]}  
      --, recursive  
      --, include_calc_members  
   ) ON 0  
   FROM [Adventure Works]  

参照

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