Manipulação de dados MDX – UPDATE CUBE

A instrução UPDATE CUBE é usada para fazer write-back de dados para qualquer célula em um cubo que é agregado a seu pai usando a agregação SUM. Para obter mais explicações e um exemplo, consulte "Noções básicas sobre alocações" nesta postagem de blog: Criando um aplicativo de write-back com o Analysis Services (blog).

Sintaxe

  
UPDATE [ CUBE ] Cube_Name   
   SET   
            <update clause>   
           [, <update clause> ...n ]  
  
<update clause> ::=   
      Tuple_Expression[.VALUE]= New_Value  
      [   
        USE_EQUAL_ALLOCATION   
        | USE_EQUAL_INCREMENT   
        | USE_WEIGHTED_ALLOCATION [ BY Weight_Expression]   
        | USE_WEIGHTED_INCREMENT [ BY Weight_Expression]  
      ]  

Argumentos

Cube_name
Uma cadeia de caracteres válida que fornece o nome de um cubo.

Tuple_Expression
Uma linguagem MDX válida que retorna uma tupla.

Novo_valor
Uma expressão numérica válida.

Weight_Expression
Uma expressão numérica MDX válida que retorna um valor decimal entre 0 e 1.

Comentários

Você pode atualizar o valor de uma célula folha ou célula não folha especificada em um cubo, alocando opcionalmente o valor para uma célula não folha especificada em células folha dependentes. A célula especificada pela expressão de tupla pode ser qualquer célula válida no espaço multidimensional (ou seja, a célula não tem de ser uma célula folha). No entanto, a célula deve ser agregada com a função de agregação Soma e não deve incluir um membro calculado na tupla usada para identificar a célula.

Pode ser útil pensar na instrução UPDATE CUBE como uma sub-rotina que gerará automaticamente uma série de operações de write-back de célula individuais para células folha e não folha que serão acumuladas em uma soma especificada.

Veja a seguir uma descrição dos métodos de alocação.

USE_EQUAL_ALLOCATION: Cada célula folha que contribui para a célula atualizada receberá um valor igual com base na expressão a seguir.

<leaf cell value> =   
<New Value> / Count(leaf cells that are contained in <tuple>)  

USE_EQUAL_INCREMENT: Cada célula folha que contribui para a célula atualizada será alterada de acordo com a expressão a seguir.

<leaf cell value> = <leaf cell value> +   
(<New Value > - <existing value>) /  
Count(leaf cells contained in <tuple>)  

USE_WEIGHTED_ALLOCATION: Cada célula folha que contribui para a célula atualizada receberá um valor igual com base na expressão a seguir.

<leaf cell value> = < New Value> * Weight_Expression  

USE_WEIGHTED_INCREMENT: Cada célula folha que contribui para a célula atualizada será alterada de acordo com a expressão a seguir.

<leaf cell value> = <leaf cell value> +   
(<New Value> - <existing value>)  * Weight_Expression  

Se uma expressão de peso não for especificada, a instrução UPDATE CUBE usará implicitamente a expressão a seguir.

Weight_Expression = <leaf cell value> / <existing value>  

Uma expressão de peso deve ser expressa como um valor decimal entre zero (0) e 1. Esse valor especifica a razão do valor alocado que você deseja atribuir às células folha afetadas pela alocação. O programador de aplicativo cliente tem a responsabilidade de criar expressões cujos valores de rollup agregados serão iguais ao valor alocado da expressão.

Cuidado

O aplicativo cliente deve considerar a alocação de todas as dimensões simultaneamente a fim de evitar possíveis resultados inesperados, inclusive valores de rollup incorretos ou dados inconsistentes.

Cada alocação de CUBO UPDATE deve ser considerada atômica para fins transacionais. Isso significa que se qualquer uma das operações de alocação falhar por alguma razão, como um erro em uma fórmula ou uma violação de segurança, toda a operação UPDATE CUBE falhará. Antes que os cálculos das operações de alocação individuais sejam processados, um instantâneo dos dados é considerado para garantir que os cálculos resultantes sejam corretos.

Cuidado

Quando usado em uma medida que contenha inteiros, o método USE_WEIGHTED_ALLOCATION pode produzir resultados imprecisos decorrentes de alterações de arredondamento incremental.

Importante

Quando células atualizadas não se sobrepõem, a propriedade de cadeia de conexão Atualizar Nível de Isolamento pode ser usada para aprimorar o desempenho de UPDATE CUBE.

Consulte Também

ConnectionString
Instruções de manipulação de dados MDX (MDX)