次の方法で共有

UPDATE CUBE ステートメント (MDX)

  • [アーティクル]

更新 : 2006 年 7 月 17 日

キューブ内の指定されたリーフ セルまたは非リーフ セルの値を更新します。指定された非リーフ セルの値を、それに依存するすべてのリーフ セルに割り当てることもできます。

構文

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
    キューブの名前を指定する有効な文字列です。
  • Tuple_Expression
    組を返す有効な多次元式 (MDX) 式です。
  • New_Value
    有効な数値式です。
  • Weight_Expression
    0 ～ 1 の範囲の 10 進値を返す有効な多次元式 (MDX) 数値式です。

解説

Tuple_Expression で指定するセルには、多次元領域内の任意の有効なセルを指定できます (リーフ セルでなくてもかまいません)。ただし、このセルは、Sum 集計関数で集計する必要があるので、セルの識別に使用する組の中に計算されるメンバを含めることはできません。

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

Weight_Expression を指定しなかった場合、UPDATE CUBE ステートメントでは、次の式が暗黙的に使用されます。

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

Weight_Expression は、0 ～ 1 の範囲の 10 進値で表す必要があります。この値には、割り当て対象となるリーフ セルに割り当てる値の比率を指定します。クライアント アプリケーションのプログラマは、式の割り当て値とロール アップ集計値が等しくなるように式を作成する必要があります。

ms145488.Caution(ja-jp,SQL.90).gif注意 :
クライアント アプリケーションでは、ロール アップ値の間違いやデータの不整合などの予期しない結果を避けるために、すべてのディメンションの割り当てを同時に検討しなければなりません。

UPDATE CUBE によるそれぞれの割り当て操作は、トランザクションとしてのアトミックな操作と見なすべきです。つまり、数式のエラーやセキュリティ違反など、何かの理由でいずれかの割り当て操作が失敗すると、UPDATE CUBE 操作全体が失敗します。個々の割り当て操作の計算が処理される前に、データのスナップショットが作成され、計算結果が正しいかどうかの確認が行われます。

ms145488.Caution(ja-jp,SQL.90).gif注意 :
整数を含むメジャーに対して USE_WEIGHTED_ALLOCATION の方法を使用すると、増分変更に丸めが伴うので不正確な結果が返される可能性があります。

参照

その他の技術情報

MDX データ操作ステートメント (MDX)

ヘルプおよび情報

SQL Server 2005 の参考資料の入手

変更履歴

リリース 履歴

2006 年 7 月 17 日
変更内容 :
  • わかりやすくするために構文および引数を更新しました。