Definição de dados MDX – ALTER CUBE
Altera a estrutura de um cubo especificado, geralmente usado para oferecer suporte ao write-back de dimensão. Para obter mais informações sobre como usar write-back em um aplicativo, consulte esta postagem no blog: Criando um aplicativo de write-back com o Analysis Services (blog)
Observe que os 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. Nenhum erro é gerado nessa situação, mas nenhuma operação pode avançar. Por fim, os dois write-backs expiram e as alterações 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 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 remover membros calculados, conjuntos nomeados, ações e cálculos 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).