Définition des données MDX - ALTER CUBE

Modifie la structure d’un cube spécifié, généralement utilisé pour supporter l’écriture en version dimensionnelle. Pour plus d’informations sur l’utilisation de la réécriture dans une application, consultez cet article de blog : Construire une application d’écriture avec des services d’analyse (blog)

Notez que les writebacks en dimension concurrente peuvent entraîner un deadlock, où la première écriture est bloquée pour un commit à cause du verrou partagé détenu par la seconde writeback. Aucune erreur n’est générée dans cette situation, mais aucune des deux opérations ne peut avancer. Finalement, les deux temps morts et les changements sont annulés.

Syntax

  
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 dimensionnel

Une nouvelle ligne est ajoutée à la table des dimensions sous-jacente.

Arguments

ParentName
Une expression de chaîne valide qui fournit le nom du parent du nouveau membre de la dimension, sauf si l’élément de la dimension est créé à la racine.

Nom du membre
Une expression de chaîne valide qui fournit un nom de membre.

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

Property_Name
Un identifiant valide d’Expressions Multidimensionnelles (MDX) qui représente une propriété membre.

Property_Value
Une expression scalaire valide des expressions multidimensionnelles (MDX) qui définit la valeur de la propriété de l’élément calculée.

Suppression d’un membre dimensionnel

Supprimer un élément de dimension d’une dimension habilitée à l’écriture supprime l’élément et sa ligne correspondante de la table de dimension sous-jacente.

Arguments

Cube_Name
Une expression de chaîne valide fournissant un nom de cube.

Member_Name
Une expression de chaîne valide fournissant un nom ou une clé membre.

Remarks

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

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 pour définir un membre par défaut. Le membre par défaut peut être spécifié pour la dimension de la base de données, une dimension de cube, ou pour la connexion d’un utilisateur. Le membre par défaut peut également être modifié pendant une session.

Arguments

Dimension_Name
Une chaîne valide qui fournit le nom d’une dimension.

MDX_Expression
Une expression MDX valide qui renvoie un seul membre.

Remarks

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

Déplacement d’un membre dimensionnel

Une ligne est modifiée dans la table des dimensions sous-jacente.

Arguments

ParentName
Une expression de chaîne valide qui fournit le nom du nouveau parent pour le membre de dimension à déplacer.

Nom du membre
Une expression de chaîne valide qui fournit un nom de membre.

Unsigned_ Entier
Un nombre valide précisant le nombre de niveaux à sauter.

Si la clause AVEC DESCENDANTS est spécifiée, l’arbre entier est déplacé. Si la clause AVEC DESCENDANTS n’est pas spécifiée, les enfants d’un parent déplacé deviennent les enfants du parent du membre déplacé. L’effet d’un déplacement est simplement de mettre à jour les valeurs de la colonne de clé parent dans la table des dimensions sous-jacente.

Mise à jour d’un membre dimensionnel

La UPDATE clause 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

Nom du membre
Une expression de chaîne valide qui fournit un nom de membre.

MDX_Expression
Une expression MDX valide qui renvoie un seul membre.

Property_Value
Une expression scalaire MDX valide qui définit la valeur de la propriété de l’élément calculée.

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, voir l’instruction DROP CELL CALCULATION (MDX).

Voir aussi

Déclarations de définition de données MDX (MDX)