ToggleDrillState (MDX)

Bascule l’état de drill des membres entre les modes drilldown et drillllup.

Syntax

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

Arguments

Set_Expression1
Une expression valide des expressions multidimensionnelles (MDX) qui retourne un ensemble.

Set_Expression2
Une expression valide des expressions multidimensionnelles (MDX) qui retourne un ensemble.

récursive
(Facultatif). Un mot-clé qui indique une comparaison récursive des ensembles. La fonction ToggleDrillState est une combinaison des fonctions DrillupMember et DrilldownMember (DrillUpMember Drilldown ). La récursion ne s’applique que lorsque le membre se trouve dans l’état Drilldownmember .

Include_calc_members
(Facultatif). Un drapeau indiquant s’il faut inclure les membres calculés, s’ils existent, au niveau du dépouillement.

Remarks

La fonction ToggleDrillState bascule l’état de forage de chaque membre du second ensemble présent dans le premier ensemble. Le premier ensemble peut contenir des uplets de n’importe quelle dimensionalité, mais le second ensemble doit contenir des membres d’une seule dimension. La fonction ToggleDrillState est une combinaison des fonctions DrillupMember et DrilldownMember (DrillUpMember Drilldown ). Si l’élément, m, du second ensemble est présent dans le premier ensemble, et que cet élément est foré (c’est-à-dire qu’il a un descendant immédiatement après), alors DrillupMember(Set_Expression1, {m}) il est appliqué au membre ou au tuplet du premier ensemble. Si ce m membre est foré vers le haut (c’est-à-dire qu’il n’existe pas de descendant de m qui suive immédiatement m), DrilldownMember(Set_Expression1, {m}[, RECURSIVE]) il est appliqué au premier ensemble.

Si le drapeau RECURSIF optionnel est utilisé, drill up et drill down sont appliqués récursivement. Pour plus d’informations sur le drapeau récursif, voir les fonctions DrillupMember et DrilldownMember (DrillupMember et Drilldownmember ).

L’interrogation de la propriété XMLA MdpropMdxDrillFunctions vous permet de vérifier le niveau de support que le serveur offre pour les fonctions de forage ; voir Propriétés XMLA prises en charge (XMLA) pour plus de détails.

Voir le journal de la base de données : MDX Set Functions : The ToggleDrillState() Function pour des scénarios et des exemples impliquant cette fonction.

Example

L’exemple suivant analyse le membre australien du premier ensemble, puis le membre États-Unis du premier ensemble.

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]