ToggleDrillState (MDX)
Fait basculer l'état d'extraction des membres entre les modes d'exploration vers le bas et d'extraction 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 est dans l'état DrilldownMember.Include_calc_members
(Facultatif). Un indicateur spécifiant s'il faut inclure les membres calculés (s'ils existent) au niveau d'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 jeu fait l'objet d'une extraction vers le bas (ce qui signifie qu'il est immédiatement suivi d'un descendant), DrillupMember(Set_Expression1, {m}) est alors appliqué au membre ou tuple dans le premier jeu. Si ce membre m est extrait vers le haut (ce qui signifie que le membre m ne possède aucun descendant situé immédiatement après lui), 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 prise en charge que le serveur fournit pour les fonctions d'extraction. Pour plus de détails, consultez Propriétés XMLA prises en charge (XMLA).
Consultez Journal de base de données : Fonctions Set MDX : la fonction ToggleDrillState() pour obtenir des scénarios et des exemples impliquant 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]