UPDATE CUBE 陳述式 (MDX)

更新： 2006 年 7 月 17 日

更新 Cube 內指定的分葉或非分葉資料格的值，選擇性地跨相依分葉資料格，配置指定的非分葉頁資料格的值。

語法

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

引數

• Cube_Name
  提供 Cube 名稱的有效字串。

• Tuple_Expression
  傳回 Tuple 的有效多維度運算式 (MDX) 運算式。

• New_Value
  有效的數值運算式。

• Weight_Expression
  傳回介於 0 和 1 間之十進位值的有效多維度運算式 (MDX) 數值運算式。

備註

由 Tuple 運算式指定的資料格可以是多維度空間的任何有效資料格 (亦即，資料格不需要是分葉資料格)。但是，資料格必須以 Sum 彙總函數彙總，而且絕不能包括 Tuple 內用以識別資料格的導出成員。

將 UPDATE CUBE 陳述式視為會自動產生一連串個別資料格的副程式，將作業回寫到會積存到指定總和的分葉與非分葉資料格，可能會有幫助。

下表描述配置方法。

配置方法	描述
USE_EQUAL_ALLOCATION	提供給更新資料格的每個分葉資料格，將會根據以下運算式指派相等的值： <leaf cell value> = <New Value> / Count(leaf cells that are contained in <tuple>)
USE_EQUAL_INCREMENT	提供給更新資料格的每個分葉資料格，將會根據以下運算式來變更： <leaf cell value> = <leaf cell value> + (<New Value > - <existing value>) / Count(leaf cells contained in <tuple>)
USE_WEIGHTED_ALLOCATION	提供給更新資料格的每個分葉資料格，將會根據以下運算式指派相等的值： <leaf cell value> = < New Value> * Weight_Expression
USE_WEIGHTED_INCREMENT	提供給更新資料格的每個分葉資料格，將會根據以下運算式來變更： <leaf cell value> = <leaf cell value> + (<New Value> - <existing value>) * Weight_Expression

如果沒有指定加權運算式，UPDATE CUBE 陳述式會隱含使用下列運算式：

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

加權運算式必須以零 (0) 到 1 之間的十進位值來表示。這個值指定您要指派給受配置影響之分葉資料格的配置值比例。用戶端應用程式設計人員負責建立的運算式，其積存彙總值將等於運算式配置值。

注意：
用戶端應用程式必須同時考慮所有維度的配置，避免發生非預期的結果，包括不正確的積存值或不一致的資料。

對於交易用途，每個 UPDATE CUBE 配置都應該視為不可部分完成。這代表，如果有任何配置作業因任何原因而失敗，例如公式有誤，或安全性違規，整個 UPDATE CUBE 作業將會失敗。處理個別配置作業之前，會先製作資料的快照集，以確定計算結果正確。

注意：
在包含整數的量值上使用時，累加的四捨五入變更會導致 USE_WEIGHTED_ALLOCATION 方法傳回不精確的結果。

請參閱

其他資源

MDX 資料操作陳述式 (MDX)

說明及資訊

取得 SQL Server 2005 協助

變更歷程記錄

版本	歷程記錄
2006 年 7 月 17 日	變更的內容： 更新了語法及引數，以便更加清楚地表示。