Instruction ALTER CUBE (MDX)

Mis à jour : 17 juillet 2006

Modifie la structure d'un cube spécifié.

Syntaxe

ALTER CUBE
      Cube_Name | CURRENTCUBE
      <alter clause> 
            [ < alter clause> ...n]
  
< alter clause> ::= 
   <create dimension member clause> 
  | <remove dimension member clause>
  | <move dimension member clause> 
    | <update clause> 
    | <create cell calculation clause>
  
<create dimension member clause> ::=
CREATE DIMENSION MEMBER [ParentName.]MemberName
    , [[KEY = Key_Value] 
    | [Property_Name = Property_Value[, ...n]]
  
<dropping clause>::=
DROP 
      DIMENSION MEMBER Member_Name 
            Member_Name ...n ] 
      [WITH DESCENDANTS]
      | [ SESSION ] [ CALCULATED ] MEMBER Member_Name 
                  [ ,Member_Name,...n ] 
    | SET Set_Name
                  [ ,Set_Name,...n ] 
    | [ SESSION ] CELL CALCULATION CellCalc_Name
                  [ ,CellCalc_Name,...n ] 
    | ACTION Action_Name
  
<move dimension member clause> ::=
MOVE DIMENSION MEMBER MemberName
        [, SKIPPED_LEVELS = Unsigned_Integer] 
      [WITH DESCENDANTS]
    UNDER ParentName    
  
<update clause> ::=
UPDATE 
    CUSTOM ROLLUP FOR MEMBER MemberName
      [,MemberName, ...n] AS MDX_Expression
   | DIMENSION Dimension_Name | Hierarchy_Name
      , DEFAULT_MEMBER = MDX_Expression
   | DIMENSION MEMBER MemberName AS
   [MDX_Expression]
      [Property_Name = Property_Value[, ...n]]
  
<create cell calculation clause>::=
CELL CALCULATION Calculation_Name 
   FOR Set_Expression AS MDX_Expression 
            [ [ CONDITION = 'Logical_Expression' ] 
    | [ DISABLED = { TRUE | FALSE } ] 
    | [ DESCRIPTION =String ] 
    | [ CALCULATION_PASS_NUMBER = Integer] 
    | [ CALCULATION_PASS_DEPTH = Integer] 
    | [ SOLVE_ORDER = Integer] 
    | [ Calculation_Name= Scalar_Expression ], ...n]

Création d'un membre de dimension

Une nouvelle ligne est ajoutée à la table de dimension sous-jacente.

Arguments

• ParentName
  Expression de chaîne valide fournissant le nom du parent du nouveau membre de dimension, sauf si le membre de dimension est créé à la racine.

• MemberName
  Expression de chaîne valide qui spécifie le nom d'un membre.

• Key_Value
  Expression scalaire valide qui définit la valeur de clé du nouveau membre de dimension.

• Property_Name
  Identificateur MDX (Multidimensional Expressions) valide représentant une propriété de membre.

• Property_Value
  Expression scalaire MDX (Multidimensional Expressions) valide qui définit la valeur de la propriété de membre calculé.

Suppression d'un membre de dimension

La suppression d'un membre de dimension d'une dimension activée en écriture signifie la suppression du membre et de sa ligne correspondante dans la table de dimension sous-jacente.

Arguments

• Cube_Name
  Expression de chaîne valide qui fournit le nom d'un cube.

• Member_Name
  Expression de chaîne valide qui précise un nom de membre ou une clé de membre.

Remarques

Si la clause WITH DESCENDANTS n'est pas utilisée, les enfants d'un membre supprimé deviennent les enfants du parent de ce dernier. Si la clause WITH DESCENDANTS n'est pas employée, tous les descendants et leurs lignes dans la table de dimension sont également supprimés.

Remarque :
Pour obtenir des informations sur la suppression de membres calculés, de jeux nommés, d'actions et de calculs de cellules, consultez Instruction DROP MEMBER (MDX), Instruction DROP SET (MDX), Instruction DROP ACTION (MDX) et Instruction DROP CELL CALCULATION (MDX).

Mise à jour du membre de dimension par défaut

Cette clause met à jour le membre par défaut d'un cube et est utilisée dans le script de calcul MDX en vue d'y définir un membre par défaut. Vous pouvez définir un membre par défaut pour la dimension de base de données, une dimension de cube ou pour la connexion d'un utilisateur. Vous pouvez également le modifier au cours d'une session.

Arguments

• Dimension_Name
  Chaîne valide qui précise le nom d'une dimension.

• MDX_Expression
  Expression MDX valide qui retourne un membre unique.

Remarques

L'expression MDX spécifiée peut être statique ou dynamique.

Déplacement d'un membre de dimension

Une ligne est modifiée dans la table de dimension sous-jacente.

Arguments

• ParentName
  Expression de chaîne valide qui fournit le nom du nouveau parent du membre de dimension déplacé.

• MemberName
  Expression de chaîne valide qui spécifie le nom d'un membre.

• Unsigned_Integer
  Nombre valide qui précise le nombre de niveaux à ignorer.

Si la clause WITH DESCENDANTS est précisée, l'arborescence tout entière est déplacée. Si la clause WITH DESCENDANTS n'est pas spécifiée, les enfants d'un parent déplacé deviennent les enfants du parent du membre déplacé. Le déplacement a simplement pour conséquence la mise à jour des valeurs de la colonne clé parente dans la table de dimension sous-jacente.

Mise à jour d'un membre de dimension

La clause UPDATE DIMENSION MEMBER vous permet de modifier les propriétés d'un membre ainsi que la formule de membre personnalisée associée à un membre.

Arguments

• MemberName
  Expression de chaîne valide qui spécifie le nom d'un membre.

• MDX_Expression
  Expression MDX valide qui retourne un membre unique.

• Property_Value
  Expression scalaire MDX valide qui définit la valeur de la propriété de membre calculé.

Création d'un calcul de cellule

Pour plus d'informations sur la création d'un calcul de cellule à l'aide de l'instruction ALTER CUBE, consultez Instruction CREATE CELL CALCULATION (MDX).

Voir aussi

Autres ressources

Instructions MDX de définition 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.