ToggleDrillState (MDX)
Active ou désactive l'état d'extraction des membres entre les modes d'extraction vers le bas et vers le haut.
Syntaxe
ToggleDrillState(Set_Expression1,Set_Expression2 [, [RECURSIVE]
[,INCLUDE_CALC_MEMBERS] ] )
Arguments
Set_Expression1
Expression MDX (Multidimensional Expressions) valide qui retourne un jeu.Set_Expression2
Expression MDX (Multidimensional Expressions) valide qui retourne un jeu.Recursive
(Facultatif). Mot clé qui indique une comparaison récursive de jeux. La fonction ToggleDrillState est une combinaison des fonctions DrillupMember et DrilldownMember. La récursivité s'applique uniquement lorsque le membre a l'état DrilldownMember.Include_calc_members
(Facultatif). Un indicateur permet d'inclure les membres calculés, s'ils existent, au niveau de l'exploration.
Notes
La fonction ToggleDrillState fait basculer l'état d'extraction de chaque membre du deuxième jeu présent dans le premier jeu. Le premier jeu peut contenir des tuples de n'importe quelle dimensionnalité mais le deuxième jeu doit contenir les membres d'une dimension unique. La fonction ToggleDrillState est une combinaison des fonctions DrillupMember et DrilldownMember. Si le membre m du deuxième jeu est présent dans le premier jeu et que ce membre fait l'objet d'une extraction vers le bas (ce qui signifie qu'il est immédiatement suivi d'un descendant), la fonction DrillupMember(Set_Expression1, {m}) est alors appliquée au membre ou tuple dans le premier jeu. Si ce membre m est extrait vers le haut (ce qui signifie qu'il n'y a aucun descendant de m situé immédiatement après m), la fonction DrilldownMember(Set_Expression1, {m}[, RECURSIVE]) est appliquée au premier jeu.
Si vous utilisez l'indicateur facultatif RECURSIVE, les extractions vers le haut et vers le bas ont lieu de manière récursive. Pour plus d'informations sur l'indicateur récursif, consultez les fonctions DrillupMember et DrilldownMember.
L'interrogation de la propriété XMLA MdpropMdxDrillFunctions vous permet de vérifier le niveau de support que le serveur fournit pour les fonctions d'extraction ; consultez Propriétés XMLA prises en charge (XMLA) pour plus de détails.
Voir l'article Database Journal: MDX Set Functions: The ToggleDrillState() Function pour obtenir des scénarios et des exemples utilisant cette fonction.
Exemple
L'exemple ci-dessous procède à une extraction vers le bas du membre Australia du premier jeu, puis à une extraction vers le haut du membre United States de ce même jeu.
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]