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.
Récursive
(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 à 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.
Remarques
La fonction ToggleDrillState bascule 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 est extrait (c’est-à-dire qu’il a un descendant immédiatement après), DrillupMember(Set_Expression1, {m}) il est appliqué au membre ou au tuple dans le premier ensemble. Si ce membre m est foré vers le haut (autrement dit, il n’y a pas de descendant de m qui suit immédiatement m), DrilldownMember(Set_Expression1, {m}[, RECURSIVE]) est appliqué au premier ensemble.
Si l’indicateur RECURSIVE facultatif est utilisé, l’extraction vers le haut et la descente vers le bas sont appliquées 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’exploration ; Consultez Propriétés XMLA prises en charge (XMLA) pour plus d’informations .
Consultez Journal de base de données : FONCTIONS DE JEU MDX : Fonction ToggleDrillState() pour les scénarios et les 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]