Alter 元素 (XMLA)

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

语法

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

元素特征

特征

说明

数据类型和长度

默认值

基数

0-n:可多次出现的可选元素。

元素关系

关系

元素

父元素

Command

子元素

ObjectObjectDefinition

属性

属性

说明

AllowCreate

(可选的 Boolean 属性)指示当 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 会话持续期间存在。

注意注意

使用 Session 设置时,ObjectDefinition 元素只能包含 DimensionCubeMiningModel ASSL 元素。

如果忽略此属性,则 ObjectDefinition 元素中定义的对象将在 Analysis Services 实例上一直存在。

注释

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

请参阅

概念

命令 (XMLA)