Definição de Dados MDX - ALTER CUBE

Altera a estrutura de um cubo especificado, tipicamente usado para suportar escrita de dimensão. Para mais informações sobre o uso de writeback em uma aplicação, veja este post do blog: Construindo uma Aplicação de Writeback com Serviços de Análise (blog)

Note que writebacks concorrentes em dimensão podem resultar em um deadlock, onde a primeira escrita é bloqueada de um commit devido ao bloqueio compartilhado mantido pela segunda writeback. Não há erro gerado nessa situação, mas nenhuma das operações consegue avançar. Eventualmente, tanto o tempo quanto as mudanças são revertidas.

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]  

Criando um Membro Dimensional

Uma nova linha é adicionada à tabela de dimensões subjacente.

Arguments

ParentName
Uma expressão de string válida que fornece o nome do pai do novo membro da dimensão, a menos que o membro da dimensão esteja sendo criado na raiz.

Nome do Membro
Uma expressão de string válida que fornece um nome de membro.

Key_Value
Uma expressão escalar válida que define o valor-chave do novo membro da dimensão.

Property_Name
Um identificador válido de Expressões Multidimensionais (MDX) que representa uma propriedade de membro.

Property_Value
Uma expressão escalar válida de Expressões Multidimensionais (MDX) que define o valor da propriedade do membro calculada.

Eliminando um membro dimensional

Eliminar um membro de dimensão de uma dimensão habilitada para gravação elimina o membro e sua linha correspondente da tabela de dimensões subjacente.

Arguments

Cube_Name
Uma expressão de string válida que fornece um nome de cubo.

Member_Name
Uma expressão de string válida que fornece um nome de membro ou chave de membro.

Remarks

Se a cláusula COM DESCENDENTES não for usada, os filhos de um membro retirado tornam-se filhos do pai ou mãe desistido. Se a cláusula WITH DESCENDANTS for usada, todos os descendentes e suas linhas na tabela de dimensões também são eliminados.

Atualizando o membro padrão da dimensão

Essa cláusula atualiza o membro padrão de um cubo e é usada no script de cálculo MDX para definir um membro padrão. O membro padrão pode ser especificado para a dimensão do banco de dados, uma dimensão de cubo ou para o login do usuário. O membro padrão também pode ser alterado durante uma sessão.

Arguments

Dimension_Name
Uma cadeia válida que fornece o nome de uma dimensão.

MDX_Expression
Uma expressão MDX válida que retorna um único membro.

Remarks

A expressão MDX especificada pode ser estática ou dinâmica.

Movendo um membro dimensional

Uma linha é modificada na tabela de dimensões subjacente.

Arguments

ParentName
Uma expressão de string válida que fornece o nome do novo pai para o membro da dimensão que está sendo movido.

Nome do Membro
Uma expressão de string válida que fornece um nome de membro.

Unsigned_Integer
Um número válido especificando o número de níveis a pular.

Se a cláusula WITH DESCENDANTS for especificada, toda a árvore é movida. Se a cláusula COM DESCENDENTES não for especificada, os filhos de um dos pais transferidos tornam-se filhos do pai ou mãe do membro transferido. O efeito de uma mudança é simplesmente atualizar os valores da coluna de chave pai na tabela de dimensões subjacente.

Atualização de um membro de dimensão

A UPDATE cláusula DIMENSION MEMBER permite modificar propriedades de um membro, bem como a fórmula personalizada de membro associada a um membro.

Arguments

Nome do Membro
Uma expressão de string válida que fornece um nome de membro.

MDX_Expression
Uma expressão MDX válida que retorna um único membro.

Property_Value
Uma expressão escalar MDX válida que define o valor da propriedade do membro calculada.

Criando um cálculo de célula

Para mais informações sobre como criar um cálculo de célula usando a instrução ALTER CUBE, veja a Declaração DROP CELL CALCULATION (MDX).

Conteúdo relacionado

• Declarações de Definição de Dados MDX (MDX)