Alter 元素 (XMLA)

包含 Analysis Services 指令碼語言 (ASSL) 元素，這些專案是由 Execute 方法用來改變 Analysis Services 實例上的物件。

Syntax

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

元素特性

特性	描述
資料類型和長度	None
預設值	None
基數	0-n：出現一次以上的選擇性元素。

元素關聯性

關聯性	元素
父元素	命令
子元素	Object、 ObjectDefinition

屬性

屬性	描述
AllowCreate	(選擇性的 布林值 屬性) 指出是否應建立 Alter 命令中所定義的物件（如果它們還不存在的話）。 如果設定為 true， ObjectDefinition 元素中定義的物件會建立在 Analysis Services 實例上（如果尚未存在的話）。 換句話說，如果物件不存在於實例上， Alter 命令會被視為 Create 命令。 如果省略此屬性或將其設定為 false，則如果物件不存在，就會發生錯誤。
ObjectExpansion	(選擇性的 Enum 屬性) 定義 Execute 方法要執行的改變範圍。 如果設定為 ObjectProperties， ObjectDefinition 元素應該只包含要改變之主要物件的完整定義，包括附屬次要物件。 要更改之物件的從屬主要物件會維持不變。 注意：使用ClrAssembly資料類型的ObjectProperties設定時，不需要指定相關聯ClrAssemblyFile資料類型的資料元素。 如果未指定， ClrAssembly 會使用現有的檔案。 如果設定為 ExpandFull，則 ObjectDefinition 元素不應只包含要改變之物件的定義，也應包含所有主要物件的定義，這些物件是要改變之物件的子系。 注意： ExpandFull 設定不能與 Server 元素一起使用。
範圍	(選擇性的 Enum 屬性) 定義 ObjectDefinition 元素中定義之物件的持續時間。 如果設定為 Session， ObjectDefinition 元素中定義的物件只會存在於 XMLA 會話的持續時間內。 注意：使用 會話 設定時， ObjectDefinition 元素只能包含 維度、 Cube或 MiningModel ASSL 元素。 如果省略這個屬性， ObjectDefinition 元素中定義的物件會保存在 Analysis Services 實例上。

備註

每個 Alter 命令都會在 ParentObject 元素所指定的父物件底下變更一個主要物件的定義。