MDXデータ定義 - ALTER CUBE

指定されたキューブの構造を変更し、通常はディメンション書き込みのサポートに使われます。 アプリケーションで書き込み返しを使う方法の詳細については、このブログ記事をご覧ください: Analysis Servicesで書き込み返しアプリケーションを構築する(ブログ)

同時進行の次元書き込みは、最初の書き込みが2番目の書き込みが保持する共有ロックのためにコミットからブロックされるデッドロックを引き起こすことがあります。 この状況ではエラーは発生しませんが、どちらの操作も進行できません。 最終的にタイムアウトと変更は元に戻されます。

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]  

次元メンバーの作成

基礎となる次元テーブルに新しい行が追加されます。

引数

ParentName
新しい次元メンバーの親名を提供する有効な文字列式ですが、次元メンバーが根元で作成されていない場合は別です。

メンバー名
メンバー名を提供する有効な文字列式。

Key_Value
新しい次元メンバーのキー値を定義する有効なスカラー式。

Property_Name
メンバープロパティを表す有効な多次元表現(MDX)識別子。

Property_Value
計算されたメンバープロパティの値を定義する有効な多次元表現(MDX)スカラー式。

次元メンバーを落とす

書き込み可能な次元から次元メンバーを削除すると、そのメンバーと対応する行が基底の次元テーブルから削除されます。

引数

Cube_Name
キューブ名を提供する有効な文字列式。

Member_Name
メンバー名またはメンバーキーを提供する有効な文字列式。

Remarks

WITH DESCENDANTS条項が使われない場合、離脱したメンバーの子はその親の子となります。 WITH DESCENDANTS節を使用する場合、次元テーブル内のすべての子孫とその行も削除されます。

Note

計算されたメンバー、名前付き集合、アクション、セル計算の削除に関する情報は、DROP MEMBER Statement(MDX)、DROP SET Statement(MDX)、DROP ACTION Statement(MDX)、DROP CELL CALCULATION STATEMENT(MDX)を参照してください。

デフォルト次元メンバーの更新

この節はキューブのデフォルトメンバーを更新し、MDX計算スクリプトでデフォルトメンバーを定義するために使われます。 デフォルトメンバーはデータベース次元、キューブ次元、またはユーザーのログイン用に指定できます。 デフォルトメンバーはセッション中に変更することも可能です。

引数

Dimension_Name
次元の名前を提供する有効な文字列。

MDX_Expression
単一のメンバーを返す有効なMDX式。

Remarks

指定されたMDX表現は静的または動的である場合があります。

次元メンバーの移動

基底となる次元テーブルの行が変更されます。

引数

ParentName
移動する次元メンバーの新しい親の名前を提供する有効な文字列式。

メンバー名
メンバー名を提供する有効な文字列式。

Unsigned_整数
スキップすべきレベル数を指定する有効な数字。

WITH DESCENDANTS節が指定されている場合、ツリー全体が移動されます。 WITH DESCENDANTS節が明記されていない場合、移動した親の子供は移動したメンバーの親の子供となります。 移動の効果は、基底となる次元テーブルの親キー列の値を更新するだけです。

ディメンションメンバーの更新

UPDATE DIMENSION MEMBER条項は、メンバーのプロパティやメンバーに関連付けられたカスタムメンバー数式を変更できるようにします。

引数

メンバー名
メンバー名を提供する有効な文字列式。

MDX_Expression
単一のメンバーを返す有効なMDX式。

Property_Value
計算されたメンバープロパティの値を定義する有効なMDXスカラー式。

セル計算の作成

ALTER CUBE文を用いたセル計算の作成についての詳細は、 DROP CELL CALCULATION STATEMENT(MDX)を参照してください。