Istruzione ALTER CUBE (MDX)

Modifica la struttura di un cubo specificato.

Sintassi

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]

Creazione di un membro in una dimensione

Viene aggiunta una riga alla tabella della dimensione sottostante.

Argomenti

  • ParentName
    Espressione stringa valida che specifica il nome del padre del nuovo membro della dimensione, a meno che questo non venga creato nella radice.

  • MemberName
    Espressione stringa valida che specifica il nome di un membro.

  • Key_Value
    Espressione scalare valida che definisce il valore chiave del nuovo membro della dimensione.

  • Property_Name
    Identificatore MDX (Multidimensional Expression) valido che rappresenta la proprietà di un membro.

  • Property_Value
    Espressione scalare MDX (Multidimensional Expression) valida che definisce il valore della proprietà di un membro calcolato.

Eliminazione di un membro in una dimensione

La rimozione di un membro da una dimensione abilitata per la scrittura consente di eliminare il membro e la riga corrispondente dalla tabella della dimensione sottostante.

Argomenti

  • Cube_Name
    Espressione stringa valida che specifica il nome di un cubo.

  • Member_Name
    Espressione stringa valida che specifica il nome o la chiave di un membro.

Osservazioni

Se non si utilizza la clausola WITH DESCENDANTS, i figli del membro eliminato diventano figli del padre di tale membro. Se si utilizza la clausola WITH DESCENDANTS, vengono inoltre eliminati tutti i discendenti e le relative righe nella tabella della dimensione.

[!NOTA]

Per informazioni sull'eliminazione di membri calcolati, set denominati, azioni e formule per il calcolo di celle, vedere Istruzione DROP MEMBER (MDX), Istruzione DROP SET (MDX), Istruzione DROP ACTION (MDX) e Istruzione DROP CELL CALCULATION (MDX).

Aggiornamento del membro predefinito in una dimensione

Questa clausola consente di aggiornare il membro predefinito di un cubo e viene utilizzata nello script di calcolo MDX per definire un membro predefinito. È possibile specificare il membro predefinito per la dimensione del database, la dimensione di un cubo o l'account di accesso di un utente. È inoltre possibile cambiare il membro predefinito durante una sessione.

Argomenti

  • Dimension_Name
    Stringa valida che specifica il nome di una dimensione.

  • MDX_Expression
    Espressione MDX valida che restituisce un unico membro.

Osservazioni

L'espressione MDX specificata può essere statica o dinamica.

Spostamento di un membro in una dimensione

Nella tabella delle dimensioni sottostante viene modificata una riga.

Argomenti

  • ParentName
    Espressione stringa valida che specifica il nome del nuovo padre per il membro della dimensione da spostare.

  • MemberName
    Espressione stringa valida che specifica il nome di un membro.

  • Unsigned_Integer
    Numero valido che specifica il numero di livelli da ignorare.

Se si specifica la clausola WITH DESCENDANTS, viene spostata l'intero albero. Se non si specifica la clausola WITH DESCENDANTS, i figli del membro spostato diventano figli del padre di tale membro. L'effetto dello spostamento è semplicemente l'aggiornamento dei valori della colonna chiave padre nella tabella della dimensione sottostante.

Aggiornamento di un membro in una dimensione

La clausola UPDATE DIMENSION MEMBER consente di modificare le proprietà di un membro oltre alla formula personalizzata membro associata a un membro.

Argomenti

  • MemberName
    Espressione stringa valida che specifica il nome di un membro.

  • MDX_Expression
    Espressione MDX valida che restituisce un unico membro.

  • Property_Value
    Espressione scalare MDX valida che definisce il valore della proprietà di un membro calcolato.

Creazione di una formula per il calcolo di celle

Per ulteriori informazioni sulla creazione di una formula per il calcolo di celle tramite l'istruzione ALTER CUBE, vedere Istruzione DROP CELL CALCULATION (MDX).