Definición de datos MDX - ALTER CUBE

Altera la estructura de un cubo especificado, normalmente utilizado para soportar la escritura de dimensión. Para más información sobre el uso de writeback en una aplicación, consulta esta entrada del blog: Construcción de una aplicación de escritura con servicios de análisis (blog)

Ten en cuenta que las escrituras de dimensión concurrente pueden provocar un deadlock, donde la primera escritura se bloquea de un compromiso debido al bloqueo compartido que mantiene la segunda escritura. No se genera ningún error en esta situación, pero ninguna de las dos operaciones puede avanzar. Eventualmente, tanto el tiempo muerto como los cambios se revierten.

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]  

Creación de un miembro dimensional

Se añade una nueva fila a la tabla de dimensiones subyacente.

Arguments

ParentName
Una expresión de cadena válida que proporciona el nombre del padre del nuevo miembro de dimensión, a menos que el miembro de dimensión se esté creando en la raíz.

Nombre del miembro
Una expresión de cadena válida que proporciona un nombre de miembro.

Key_Value
Una expresión escalar válida que define el valor clave del nuevo miembro de la dimensión.

Property_Name
Un identificador válido de Expresiones Multidimensionales (MDX) que representa una propiedad de miembro.

Property_Value
Una expresión escalar válida de Expresiones Multidimensionales (MDX) que define el valor de la propiedad del miembro calculado.

Eliminar un miembro dimensional

Eliminar un miembro dimensional de una dimensión habilitada para escritura elimina el miembro y su fila correspondiente de la tabla de dimensiones subyacente.

Arguments

Cube_Name
Una expresión de cadena válida que proporciona un nombre de cubo.

Member_Name
Una expresión de cadena válida que proporcione un nombre o clave de miembro (member name).

Remarks

Si no se utiliza la cláusula CON DESCENDIENTES, los hijos de un miembro que se ha dado de baja se convierten en hijos del progenitor del miembro que se ha dado de baja. Si se utiliza la cláusula CON DESCENDIENTES, también se eliminan todos los descendientes y sus filas en la tabla de dimensiones.

Actualización del miembro de dimensión por defecto

Esta cláusula actualiza el miembro por defecto de un cubo y se utiliza en el script de cálculo MDX para definir un miembro por defecto. El miembro por defecto puede especificarse para la dimensión de la base de datos, una dimensión de cubo o para el inicio de sesión del usuario. El miembro predeterminado también puede cambiarse durante una sesión.

Arguments

Dimension_Name
Una cadena válida que proporciona el nombre de una dimensión.

MDX_Expression
Una expresión MDX válida que devuelve un solo miembro.

Remarks

La expresión MDX especificada puede ser estática o dinámica.

Moviendo un miembro dimensional

Una fila se modifica en la tabla de dimensiones subyacente.

Arguments

ParentName
Una expresión de cadena válida que proporcione el nombre del nuevo padre para el miembro de dimensión que se está moviendo.

Nombre del miembro
Una expresión de cadena válida que proporciona un nombre de miembro.

Unsigned_Entero
Un número válido que especifica el número de niveles a saltar.

Si se especifica la cláusula WITH DESCENDANTS, se mueve todo el árbol. Si no se especifica la cláusula CON DESCENDENCIA, los hijos de un progenitor trasladado se convierten en hijos del progenitor del miembro trasladado. El efecto de un movimiento es simplemente actualizar los valores de la columna de clave principal en la tabla de dimensiones subyacente.

Actualización de un miembro de dimensión

La UPDATE cláusula DIMENSION MEMBER permite modificar propiedades de un miembro así como la fórmula personalizada de miembro asociada a dicho miembro.

Arguments

Nombre del miembro
Una expresión de cadena válida que proporciona un nombre de miembro.

MDX_Expression
Una expresión MDX válida que devuelve un solo miembro.

Property_Value
Una expresión escalar MDX válida que defina el valor de la propiedad del miembro calculado.

Creación de un cálculo de celda

Para más información sobre cómo crear un cálculo de celda usando la instrucción ALTER CUBE, véase la Declaración DROP CELL CALCULATION (MDX).

Véase también

Declaraciones de definición de datos MDX (MDX)