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).