DrilldownMember (MDX)
Extrait vers le bas les membres dans un jeu spécifié, qui sont présents dans un second jeu spécifié.
La fonction extrait également vers le bas un jeu de tuples à l'aide de la première hiérarchie de tuple ou de la hiérarchie éventuellement spécifiée.
Syntaxe
DrillDownMember(<Set_Expression1>, <Set_Expression2> [,[<Target_Hierarchy>]] [,[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.Target_Hierarchy
Expression MDX (Multidimensional Expressions) valide qui retourne une hiérarchie.Recursive
Mot clé qui indique une comparaison récursive de jeux.Include_Calc_Members
Mot clé permettant d'activer les membres calculés à inclure dans les résultats de l'extraction vers le bas.
Notes
Cette fonction retourne un jeu de membres enfants classés par hiérarchie, et inclut les membres spécifiés dans le premier jeu qui sont également présents dans le deuxième jeu. Les membres parents ne font pas l'objet d'une exploration vers le bas si le premier jeu contient le membre parent et un ou plusieurs enfants. Le premier jeu peut avoir n'importe quelle dimensionnalité mais le deuxième jeu doit contenir un jeu unidimensionnel. L'ordre est conservé parmi les membres d'origine dans le premier jeu, à ceci près que tous les membres enfants inclus dans l'ensemble de résultats de la fonction sont placés immédiatement après leur membre parent. La fonction construit l'ensemble de résultats en récupérant les enfants de chaque membre dans le premier jeu également présent dans le deuxième jeu. Si RECURSIVE est spécifié, la fonction continue à comparer de manière récursive les membres du jeu de résultats par rapport au deuxième jeu en récupérant les enfants de chaque membre du jeu de résultats également présent dans le deuxième jeu jusqu'à ce que plus aucun membre de l'ensemble de résultats ne puisse être détecté dans le deuxième jeu.
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).
Le premier jeu peut contenir des tuples au lieu de membres. L'exploration vers le bas des tuples est une extension d'OLE DB et retourne un jeu de tuples à la place des membres
Important
Un membre ne fait pas l'objet d'une exploration vers le bas s'il est aussitôt suivi d'un de ses enfants. L'ordre des membres dans le jeu importe autant pour les familles de fonctions Drilldown* et Drillup*.
Exemples
L'exemple ci-dessous descend les niveaux concernant l'Australie, soit le membre du premier jeu également présent dans le deuxième jeu.
SELECT DrilldownMember
( [Geography].[Geography].Children,
{[Geography].[Geography].[Country].[Australia],
[Geography].[Geography].[State-Province].[New South Wales]}
)
ON 0
FROM [Adventure Works]
L'exemple ci-dessous descend les niveaux concernant l'Australie, soit le membre du premier jeu également présent dans le deuxième jeu. Néanmoins, du fait de la présence de l'argument RECURSIVE, la fonction continue à comparer de manière récursive les membres de l'ensemble des résultats (membres du niveau State-Province) par rapport au deuxième jeu et extrait simultanément les enfants de chaque membre de l'ensemble de résultats (membres du niveau City) également présent dans le deuxième jeu jusqu'à ce que plus aucun membre de l'ensemble de résultats ne puisse être détecté dans le deuxième jeu.
SELECT DrilldownMember
( [Geography].[Geography].Children,
{[Geography].[Geography].[Country].[Australia],
[Geography].[Geography].[State-Province].[New South Wales]}
,RECURSIVE)
ON 0
FROM [Adventure Works]