Alter 元素 (XMLA)

包含 Analysis Services 脚本语言 (ASSL) 元素，这些元素由 Execute 方法用来在 Analysis Services 的实例上更改对象。

语法

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

元素特征

特征	说明
数据类型和长度	无
默认值	无
基数	0-n：可多次出现的可选元素。

元素关系

关系	元素
父元素	命令
子元素	Object、 ObjectDefinition

属性

属性	说明
AllowCreate	(可选的 布尔值 特性) 指示是否应在 Alter 命令中定义的对象不存在时进行创建。 如果设置为 true，则在 Analysis Services 实例上创建在 ObjectDefinition 元素中定义的对象（如果它们尚不存在）。 换言之，如果实例中尚不存在这些对象，则将 Alter 命令视为 Create 命令。 如果省略此属性或将其设置为 false，则会在对象不存在时出现错误。
ObjectExpansion	(可选 枚举 特性) 定义要由 Execute 方法执行的更改的范围。 如果设置为 ObjectProperties，则 ObjectDefinition 元素应该只包含要更改的主要对象的完整定义，包括从属次要对象。 要更改的对象的从属主要对象保持不变。 注意：将ObjectProperties设置与ClrAssembly数据类型一起使用时，不需要指定关联ClrAssemblyFile数据类型的数据元素。 如果未指定， ClrAssembly 将使用现有文件。 如果设置为 updateoptions.expandfull，则 ObjectDefinition 元素不仅应该包含要更改的对象的定义，还应包含作为要更改的对象的后代的所有主要对象的定义。 注意： updateoptions.expandfull 设置不能与 Server 元素一起使用。
范围	(可选 枚举 特性) 定义 ObjectDefinition 元素中定义的对象的持续时间。 如果设置为 Session，则 ObjectDefinition 元素中定义的对象只存在于 XMLA 会话的持续时间内。 注意：使用 会话 设置时， ObjectDefinition 元素只能包含 Dimension、 Cube或 MiningModel ASSL 元素。 如果省略此属性，则 ObjectDefinition 元素中定义的对象将保留在 Analysis Services 实例上。

备注

每个 Alter 命令更改 ParentObject 元素所指定的父对象下一个主要对象的定义。