Alter 要素 (XMLA)

Execute メソッドAnalysis Servicesインスタンス上のオブジェクトを変更するために使用されるスクリプト言語 (ASSL) 要素をAnalysis Services。

構文

  
<Command>  
   <Alter Scope="enum" AllowCreate="boolean" ObjectExpansion="enum">  
      <Object>...</Object>  
      <ObjectDefinition>...</ObjectDefinition>  
   </Alter>  
</Command>  

要素の特性

特徴 説明
データ型と長さ なし
既定値 なし
カーディナリティ 0-n : 省略可能な要素で、出現する場合は複数回の出現が可能です

要素リレーションシップ

リレーションシップ 要素
親要素 コマンド
子要素 ObjectObjectDefinition

属性

属性 説明
AllowCreate (省略 可能なブール 属性) Alter コマンドで定義されているオブジェクトが存在しない場合に作成するかどうかを示します。

true に設定すると、 ObjectDefinition 要素で定義されているオブジェクトは、Analysis Servicesインスタンスに作成されます (まだ存在しない場合)。 つまり、オブジェクトがインスタンスにまだ存在しない場合、 Alter コマンドは Create コマンドとして扱います。

この属性を省略するか、 false に設定すると、オブジェクトが存在しない場合にエラーが発生します。
ObjectExpansion (省略 可能な Enum 属性)Execute メソッドによって実行される変更の範囲を 定義 します。

ObjectProperties に設定した場合、ObjectDefinition 要素には、下位のマイナー オブジェクトを含め、変更するメジャー オブジェクトの完全な定義のみを含む必要があります。 変更対象のオブジェクトの下位にある主要なオブジェクトは変更されません。

注: ObjectProperties 設定を ClrAssembly データ型と一緒に使用する場合、関連付けられている ClrAssemblyFile データ型の Data 要素を指定する必要があります。 指定しない場合、 ClrAssembly は既存のファイル を使用します。

ExpandFull に設定した場合、ObjectDefinition 要素には、変更するオブジェクトの定義だけでなく、変更するオブジェクトの子孫であるすべての主要オブジェクトの定義も含まれている必要があります。

注: ExpandFull 設定 を Server 要素と一緒に 使用 することはできません。
Scope (省略 可能な Enum 属性)ObjectDefinition 要素で定義されているオブジェクト の期間を定義 します。

Session に 設定した場合、 ObjectDefinition 要素で定義されているオブジェクトは、XMLA セッション中のみ存在します。

注: セッション設定を 使用する 場合、 ObjectDefinition 要素には DimensionCubeまたは MiningModel ASSL 要素のみを含めできます。

この属性を省略した場合、 ObjectDefinition 要素で定義されているオブジェクトは、インスタンスAnalysis Servicesされます。

注釈

Alter コマンド は、ParentObject 要素で指定された親オブジェクトの下にある 1 つのメジャー オブジェクト の定義を変更 します。