Manipolazione dei dati MDX - UPDATE CUBE

L'istruzione UPDATE CUBE viene utilizzata per eseguire il writeback dei dati in qualsiasi cella di un cubo aggregato al relativo elemento padre mediante l'aggregazione SUM. Per altre spiegazioni e un esempio, vedere "Informazioni sulle allocazioni" in questo post di blog: Compilazione di un'applicazione writeback con Analysis Services (blog).

Sintassi

  
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]  
      ]  

Argomenti

Cube_Name
Stringa valida che specifica il nome di un cubo.

Tuple_Expression
Espressione MDX (Multidimensional Expression) valida che restituisce una tupla.

New_Value
Espressione numerica valida.

Weight_Expression
Espressione numerica MDX (Multidimensional Expression) valida che restituisce un valore decimale compreso tra 0 e 1.

Osservazioni:

È possibile aggiornare il valore di una cella foglia o non foglia specificata di un cubo, allocando facoltativamente il valore di una cella non foglia specificata a celle foglia dipendenti. La cella specificata dall'espressione di tupla può essere una cella valida qualsiasi dello spazio multidimensionale, ovvero la cella non deve essere necessariamente una cella foglia. Tuttavia, la cella deve essere aggregata con la funzione di aggregazione Sum e non deve includere un membro calcolato nella tupla utilizzata per identificare la cella.

Può essere utile considerare l'istruzione UPDATE CUBE come una subroutine che genererà automaticamente una serie di singole operazioni di writeback delle celle in celle foglia e non foglia che verranno rifornite in una somma specificata.

Di seguito è riportata una descrizione dei metodi di allocazione.

USE_EQUAL_ALLOCATION: a ogni cella foglia che contribuisce alla cella aggiornata verrà assegnato un valore uguale in base all'espressione seguente.

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

USE_EQUAL_INCREMENT: ogni cella foglia che contribuisce alla cella aggiornata verrà modificata in base all'espressione seguente.

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

USE_WEIGHTED_ALLOCATION: a ogni cella foglia che contribuisce alla cella aggiornata verrà assegnato un valore uguale basato sull'espressione seguente.

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

USE_WEIGHTED_INCREMENT: ogni cella foglia che contribuisce alla cella aggiornata verrà modificata in base all'espressione seguente.

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

Se non viene specificata un'espressione weight, l'istruzione UPDATE CUBE usa in modo implicito l'espressione seguente.

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

Un'espressione di ponderazione deve essere espressa come valore decimale compreso tra zero (0) e 1. Questo valore specifica il rapporto del valore allocato che si desidera assegnare alle celle foglia interessate dall'allocazione. È responsabilità dello sviluppatore dell'applicazione client creare espressioni con valori aggregati di rollup uguali ai valori allocati dalle espressioni.

Ogni allocazione UPDATE CUBE deve essere considerata atomica a scopo transazionale. Ciò significa che, se una delle operazioni di allocazione ha esito negativo, ad esempio nel caso di errore in una formula o di una violazione di sicurezza, l'intera operazione UPDATE CUBE avrà esito negativo. Prima dell'elaborazione dei calcoli delle singole operazioni di allocazione viene eseguito uno snapshot dei dati per assicurare che i calcoli risultanti siano corretti.

Vedi anche

ConnectionString
Istruzioni MDX per la manipolazione dei dati (MDX)