MDX データ操作 - ALTER CUBE
指定されたキューブの構造を変更します。通常、ディメンションの書き戻しをサポートするために使用されます。 アプリケーションでの書き戻しの使用の詳細については、次のブログ投稿を参照してください: Analysis Services を使用した書き戻しアプリケーションの構築 (ブログ)
同時ディメンション の書き戻しではデッドロックが発生する可能性があり、2 番目の書き戻しによって共有ロックが保持されているため、最初の書き戻しはコミットからブロックされます。 このような状況では、エラーは生成されません。また、どのような操作も実行されません。 最終的には、タイムアウトと変更の両方がロールバックされます。
構文
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
メンバー名またはメンバー キーを指定する有効な文字列式。
解説
WITH DESCENDANTS 句を使用しなかった場合、削除したメンバーの子は、削除したメンバーの親の子になります。 WITH DESCENDANTS 句を使用すると、ディメンション テーブル内のすべての子孫とその行も削除されます。
注意
計算されるメンバー、名前付きセット、アクション、およびセルの計算を削除する方法については、「DROP MEMBER ステートメント (MDX)」、DROP SET ステートメント (MDX)、DROP ACTION ステートメント (MDX)、DROP CELL CALCULATION ステートメント (MDX)に関するページを参照してください。
既定のディメンション メンバーの更新
この句はキューブの既定のメンバーを更新し、既定のメンバーを定義するために MDX 計算スクリプトで使用されます。 データベース ディメンション、キューブ ディメンション、またはユーザー ログインの既定のメンバーを指定できます。 既定のメンバーは、セッション中に変更することもできます。
引数
Dimension_Name
ディメンションの名前を提供する有効な文字列。
MDX_Expression
1 つのメンバーを返す有効な MDX 式。
解説
指定した MDX 式は、静的または動的にすることができます。
ディメンション メンバーの移動
基になるディメンション テーブルの行が変更されます。
引数
ParentName
移動するディメンション メンバーの新しい親の名前を提供する有効な文字列式。
メンバー名
メンバー名を提供する有効な文字列式。
Unsigned_Integer
スキップするレベル数を指定する有効な数値です。
WITH DESCENDANTS 句を指定すると、ツリー全体が移動します。 WITH DESCENDANTS を指定しなかった場合、移動した親の子は、移動したメンバーの親の子になります。 移動の効果は、基になるディメンション テーブルの親キー列の値を更新することです。
ディメンション メンバーの更新
UPDATE DIMENSION MEMBER 句を使用すると、メンバーのプロパティと、メンバーに関連付けられているカスタム メンバー式を変更できます。
引数
メンバー名
メンバー名を提供する有効な文字列式。
MDX_Expression
1 つのメンバーを返す有効な MDX 式。
Property_Value
計算されるメンバー プロパティの値を定義する有効な MDX スカラー式。
セル計算の作成
ALTER CUBE ステートメントを使用してセル計算を作成する方法の詳細については、「 DROP CELL CALCULATION ステートメント (MDX)」を参照してください。