Instruction SCOPE (MDX)

Mis à jour : 17 juillet 2006

Limite l'étendue des instructions MDX (Multidimensional Expressions) spécifiées à un sous-cube spécifié.

Syntaxe

SCOPE(Subcube_Expression) 
   [ MDX_Statement ]
END SCOPE

Subcube_Expression ::= (Auxiliary_Subcube [, Auxiliary_Subcube,...n])

Auxiliary_Subcube ::= 
        Limited_Set 
    | Root([dimension_name]) 
    | Leaves([dimension_name])

Limited_Set ::= 
        single_tuple 
    | member 
    | Common_Grain_Members 
    | hierarchy.members 
    | level.members 
    | {} 
    | Descendants
            (
                  Member
                  , [level
          [
                        , SELF 
                          | AFTER 
                          | BEFORE 
                          | SELF_AND_AFTER 
                          | SELF_AND_BEFORE 
                          | SELF_BEFORE_AFTER 
                          | LEAVES
                  ]
            ) 
[* <limited set>]

Arguments

• Subcube_Expression
  Expression de sous-cube MDX valide.

• MDX_Statement
  Instruction MDX valide.

• Common_Grain_Members
  Instruction MDX valide qui évalue les membres qui ont la même granularité.

• single_tuple
  Tuple unique.

Notes

L'instruction SCOPE détermine le sous-cube qui sera affecté par l'exécution d'une ou plusieurs instructions MDX. Sauf si une instruction MDX est insérée dans une instruction SCOPE, l'étendue implicite d'une instruction MDX est le cube tout entier.

Remarque :
Les membres cachés sont exposés dans les instructions SCOPE.

Les instructions SCOPE créent des sous-cubes qui exposent les « trous » quel que soit le paramètre MDX Compatibility. Par exemple, l'instruction Scope( Customer.State.members ) peut inclure les états de pays ou de régions qui n'ont pas d'états, mais dans lesquels des trous ont été insérés.

Les membres calculés et les jeux nommés créés dans le cadre d'une instruction SCOPE ne sont pas affectés par l'instruction SCOPE.

Exemple

L'exemple ci-dessous tiré du script de calcul MDX inclus dans la solution exemple Adventure Works, définit l'étendue actuelle en tant que trimestre fiscal de l'année fiscale 2005 et la mesure de quota du montant des ventes, puis assigne une valeur aux cellules dans l'étendue actuelle à l'aide de la fonction ParallelPeriod. L'exemple modifie ensuite l'étendue par le biais d'une autre instruction SCOPE, puis procède à une autre assignation à l'aide de la fonction This (MDX).

Scope 
 ( 
    [Date].[Fiscal Year].&[2005],
    [Date].[Fiscal].[Fiscal Quarter].Members,
    [Measures].[Sales Amount Quota]
 ) ;   
   
   This = ParallelPeriod                             
          ( 
             [Date].[Fiscal].[Fiscal Year], 1,
             [Date].[Fiscal].CurrentMember 
          ) * 1.35 ;
 

/*-- Allocate equally to months in FY 2002 -----------------------------*/

  Scope 
  ( 
     [Date].[Fiscal Year].&[2002],
     [Date].[Fiscal].[Month].Members 
  ) ;   

    This = [Date].[Fiscal].CurrentMember.Parent / 3 ;   

  End Scope ;   

Voir aussi

Autres ressources

Instructions de script MDX (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.