Partager via


Instruction ALTER CUBE (MDX)

Modifie la structure d'un cube spécifié, généralement pour prendre en charge l'écriture différée de dimension. Pour plus d'informations sur l'utilisation de l'écriture différée dans une application, consultez cet article de blog : Développement d'une application d'écriture différée avec Analysis Services (en anglais)

Notez que les écritures différées simultanées de dimension peuvent provoquer un blocage, dans lequel la première écriture différée n'est pas validée du fait que le verrou partagé est détenu par la seconde écriture différée. Aucun message d'erreur n'est généré dans cette situation, mais aucune opération ne peut se poursuivre. Le délai d'attente de ces deux opérations finit par expirer et les modifications sont annulées.

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.

Notes

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.

Notes

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 DROP CELL CALCULATION (MDX).

Voir aussi

Autres ressources

Instructions MDX de définition de données (MDX)