Instruction DRILLTHROUGH (MDX)

Article
12/15/2008

Mis à jour : 17 juillet 2006

Extrait les lignes de la table sous-jacente qui ont été utilisées pour créer une cellule spécifiée dans un cube.

Syntaxe

DRILLTHROUGH [MAXROWS Unsigned_Integer] 
      <MDX SELECT statement> 
      [RETURN Set_of_Attributes_and_Measures 
            [,Set_of_Attributes_and_Measures ...]
      ]

Arguments

Unsigned_Integer
Valeur d'entier positif.

MDX SELECT statement
N'importe quelle instruction SELECT MDX (Multidimensional Expressions) valide.

Set_of_Attributes_and_Measures
Liste séparée par des virgules d'attributs de dimension et de mesures.

Notes

L'extraction est une opération au cours de laquelle un utilisateur final sélectionne une cellule unique dans un cube et extrait un ensemble de résultats des données source de cette cellule pour se procurer des informations plus détaillées. Par défaut, un ensemble de résultats obtenus par extraction provient des lignes de la table qui ont été évaluées afin de calculer la valeur de la cellule sélectionnée dans le cube. Pour être en mesure de procéder à une extraction, les utilisateurs finaux doivent disposer de cette fonctionnalité sur leurs applications clientes. Dans Microsoft SQL Server 2005 Analysis Services (SSAS), les résultats sont extraits directement du stockage MOLAP, sauf si des partitions ou des dimensions ROLAP sont interrogées.

Important :
La sécurité de l'extraction est basée sur les options de sécurité générales définies dans le cube. Si un utilisateur ne parvient pas à se procurer des données via MDX, l'extraction limite aussi l'utilisateur exactement de la même manière.

Une instruction MDX spécifie la cellule concernée. La valeur spécifiée par l'argument MAXROWS indique le nombre maximal de lignes qui doit être retourné par l'ensemble de lignes obtenu. Sauf indication contraire, les colonnes retournées incluent tous les attributs de granularité de toutes les dimensions (autres que les dimensions de type plusieurs à plusieurs) associées au groupe de mesures. Les dimensions du cube sont précédées du signe $ afin de distinguer les dimensions et les groupes de mesures. La clause RETURN est utilisée pour spécifier les colonnes retournées par la requête d'extraction. Les fonctions suivantes peuvent être appliquées à un attribut ou une mesure unique avec la clause RETURN.

Name(attribute_name)
Retourne le nom du membre d'attribut spécifié.

UniqueName(attribute_name)
Retourne le nom unique du membre d'attribut spécifié.

Key(attribute_name[, N])
Retourne la clé du membre d'attribut spécifié, où N spécifie la colonne dans la clé composite (le cas échéant). La valeur par défaut pour N est 1.

Caption(attribute_name)
Retourne la légende du membre d'attribut spécifié.

MemberValue(attribute_name)
Retourne la valeur de membre du membre d'attribut spécifié.

Translation(attribute_name[, N])
Retourne la valeur traduite du membre d'attribut spécifié, où N désigne la langue.

CustomRollup(attribute_name)
Retourne l'expression de cumul personnalisé du membre d'attribut spécifié.

CustomRollupProperties(attribute_name)
Retourne les propriétés de cumul personnalisé du membre d'attribut spécifié.

UnaryOperator(attribute_name)
Retourne l'opérateur unaire du membre d'attribut spécifié.

Exemple

L'exemple suivant spécifie la cellule du mois de juillet 2003 pour la mesure (mesure par défaut) Reseller Sales Amount (montant des ventes du revendeur) pour l'Australie. La clause RETURN précise que les valeurs sous-jacentes de cette cellule (valeurs concernant la date de chaque vente, le nom du modèle de produit, le nom de l'employé, le montant des ventes, le montant des taxes et le coût du produit) sont à retourner.

DRILLTHROUGH
SELECT
   ([Date].[Calendar].[Month].[July 2003])
ON 0 
FROM [Adventure Works]
WHERE [Geography].[Country].[Australia]
RETURN 
  [$Date].[Date]
  ,KEY([$Product].[Model Name])
  ,NAME([$Employee].[Employee])
  ,[Reseller Sales].[Reseller Sales Amount]
  ,[Reseller Sales].[Reseller Tax Amount]
  ,[Reseller Sales].[Reseller Standard Product Cost]

Voir aussi

Autres ressources

Instructions MDX de manipulation de données (MDX)

Aide et Informations

Assistance sur SQL Server 2005

Historique des modifications

Version	Historique
17 juillet 2006	Contenu modifié : Mise à jour de la syntaxe et des arguments à des fins d'éclaircissement. Ajout d'exemples mis à jour.