Share via


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

Terme

Définition

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 seront pas extraits 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 support que le serveur fournit pour les fonctions d'extraction ; consultez Propriétés XMLA prises en charge (XMLA) pour plus de détails.

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]