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

  • [アーティクル]

更新 : 2006 年 7 月 17 日

指定されたキューブの構造を変更します。

構文

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
    新しいディメンション メンバの親の名前を指定する有効な文字列式です。ディメンション メンバをルート以外の場所に作成する場合に指定します。
  • MemberName
    メンバ名を指定する有効な文字列式です。
  • Key_Value
    新しいディメンション メンバのキー値を定義する有効なスカラ式です。
  • Property_Name
    メンバ プロパティを表す有効な多次元式 (MDX) 識別子です。
  • Property_Value
    計算されるメンバ プロパティの値を定義する有効な多次元式 (MDX) スカラ式です。

ディメンション メンバの削除

書き込み可能なディメンションからディメンション メンバを削除すると、基になるディメンション テーブルからそのメンバおよび対応する行が削除されます。

引数

  • Cube_Name
    キューブ名を指定する有効な文字列式です。
  • Member_Name
    メンバ名またはメンバ キーを指定する有効な文字列式です。

解説

WITH DESCENDANTS 句を使用しなかった場合、削除したメンバの子は、削除したメンバの親の子になります。WITH DESCENDANTS 句を使用した場合、ディメンション テーブル内にあるすべての子孫および対応する行が削除されます。

ms144822.note(ja-jp,SQL.90).gifメモ :
計算されるメンバ、名前付きセット、アクション、およびセル計算の削除の詳細については、「DROP MEMBER ステートメント (MDX)」、「DROP SET ステートメント (MDX)」、「DROP ACTION ステートメント (MDX)」、および「DROP CELL CALCULATION ステートメント (MDX)」を参照してください。

既定のディメンション メンバの更新

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

引数

  • Dimension_Name
    ディメンションの名前を指定する有効な文字列です。
  • MDX_Expression
    メンバを 1 つ返す有効な MDX 式です。

解説

指定する MDX 式は、静的であっても動的であってもかまいません。

ディメンション メンバの移動

基になるディメンション テーブルの行が変更されます。

引数

  • ParentName
    移動するディメンション メンバの新しい親の名前を指定する有効な文字列式です。
  • MemberName
    メンバ名を指定する有効な文字列式です。
  • Unsigned_Integer
    スキップするレベル数を指定する有効な数値です。

WITH DESCENDANTS を指定した場合は、ツリー全体が移動されます。WITH DESCENDANTS を指定しなかった場合、移動した親の子は、移動したメンバの親の子になります。移動を行うことによる影響は、簡単にいえば、基になるディメンション テーブルの親キー列の値を更新することです。

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

UPDATE DIMENSION MEMBER 句を使用すると、メンバのプロパティだけでなく、メンバに関連付けられているカスタム メンバ式も変更できます。

引数

  • MemberName
    メンバ名を指定する有効な文字列式です。
  • MDX_Expression
    メンバを 1 つ返す有効な MDX 式です。
  • Property_Value
    計算されるメンバ プロパティの値を定義する有効な MDX スカラ式です。

セル計算の作成

ALTER CUBE ステートメントを使用してセル計算を作成する方法の詳細については、「CREATE CELL CALCULATION ステートメント (MDX)」を参照してください。

参照

その他の技術情報

MDX データ定義ステートメント (MDX)

ヘルプおよび情報

SQL Server 2005 の参考資料の入手

変更履歴

リリース 履歴

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