Instrução ALTER CUBE (MDX)

Altera a estrutura de um cubo especificado, que costuma ser usado para dar suporte ao write-back de dimensão. Para obter mais informações sobre o uso do write-back em um aplicativo, consulte esta postagem de blog: Building a Writeback Application with Analysis Services (blog)

Note que write-backs de dimensão simultâneos podem resultar em um deadlock, onde o primeiro write-back é bloqueado de uma confirmação, devido ao bloqueio compartilhado mantido pelo segundo write-back. Não há erro gerado nessa situação, mas nenhuma operação pode avançar. Por fim, os dois expiram e as alterações são revertidas.

Sintaxe

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 de dimensão

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

Argumentos

• ParentName
  Uma expressão de cadeia de caracteres válida que fornece o nome do pai do novo membro de dimensão, a não ser que o membro esteja sendo criado na raiz.

• MemberName
  Uma expressão de cadeia de caracteres válida que fornece um nome de membro.

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

• Property_Name
  Um identificador MDX válido que representa uma propriedade de membro.

• Property_Value
  Uma expressão escalar MDX válida que define o valor de propriedade do membro calculado.

Descartando um membro de dimensão

O descarte de um membro de uma dimensão habilitada para gravação exclui o membro e a linha correspondente da tabela de dimensões subjacente.

Argumentos

• Cube_Name
  Uma expressão de cadeia de caracteres válida que fornece um nome de cubo.

• Member_Name
  Uma expressão de cadeia de caracteres válida que fornece um nome ou uma chave de membro.

Comentários

Se a cláusula WITH DESCENDANTS não for utilizada, os filhos de um membro descartado se tornam filhos do pai do membro descartado. Se a cláusula WITH DESCENDENTES for utilizada, todos os descendentes e suas linhas na tabela de dimensões também serão descartados.

Observação
Para obter informações sobre como descartar membros calculados, conjuntos nomeados, ações e calculus de célula, consulte Instrução DROP MEMBER (MDX), Instrução DROP SET (MDX), Instrução DROP ACTION (MDX) e Instrução DROP CELL CALCULATION (MDX).

Atualizando o membro de dimensão padrã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 de banco de dados, uma dimensão de cubo ou para o logon de um usuário. O membro padrão também pode ser alterado durante uma sessão.

Argumentos

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

• MDX_Expression
  Uma linguagem MDX válida que retorna um único membro.

Comentários

A linguagem MDX especificada pode ser estática ou dinâmica.

Movendo um membro de dimensão

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

Argumentos

• ParentName
  Uma expressão de cadeia de caracteres válida que fornece o nome do novo pai do membro de dimensão que está sendo movido.

• MemberName
  Uma expressão de cadeia de caracteres válida que fornece um nome de membro.

• Unsigned_Integer
  Um número válido que especifica o número de níveis a serem ignorados.

Se a cláusula WITH DESCENDENTES for especificada, a árvore inteira será movida. Se a cláusula WITH DESCENDANTS não for especificada, os filhos de um pai movido se tornam filhos do pai do membro movido. A movimentação é feita simplesmente para atualizar os valores da coluna principal de pais na tabela de dimensões subjacente.

Atualizando um membro de dimensão

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

Argumentos

• MemberName
  Uma expressão de cadeia de caracteres válida que fornece um nome de membro.

• MDX_Expression
  Uma linguagem MDX válida que retorna um único membro.

• Property_Value
  Uma expressão MDX escalar válida que define o valor de propriedade do membro calculado.

Criando um cálculo de célula

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

Consulte também

Outros recursos

Instruções de definição de dados MDX (MDX)