Compartir a través de


Elemento Alter (XMLA)

Contiene elementos del Lenguaje de scripting de Analysis Services (ASSL) utilizados por el método Execute para modificar objetos en una instancia de Microsoft SQL Server Analysis Services.

Sintaxis

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

Características de los elementos

Característica

Descripción

Tipo y longitud de los datos

Ninguno

Valor predeterminado

Ninguno

Cardinalidad

0-n: Elemento opcional que puede tener lugar más de una vez.

Relaciones del elemento

Relación

Elemento

Elementos primarios

Command

Elementos secundarios

Object, ObjectDefinition

Atributos

Atributo

Descripción

AllowCreate

(Atributo Boolean opcional). Indica si deberían crearse los objetos definidos en el comando Alter en caso de que no aún no existan.

Si está establecido en true, los objetos definidos en el elemento ObjectDefinition se crean en la instancia de Analysis Services si aún no existen. En otras palabras, el comando Alter se trata como un comando Create si los objetos aún no existen en la instancia.

Si este atributo se omite o se establece a false, se producirá un error si los objetos aún no existen.

ObjectExpansion

(Atributo Enum opcional). Define la extensión de la modificación que va a realizar el método Execute.

Si está establecido en ObjectProperties, el elemento ObjectDefinition debería contener únicamente la definición completa del objeto principal a modificar, incluyendo los objetos secundarios subordinados. Los objetos principales subordinados al objeto que se va a modificar no se modificarán.

[!NOTA]

Al utilizar el valor ObjectProperties con el tipo de dato ClrAssembly, no es necesario especificar el elemento Data de los tipos de datos ClrAssemblyFile asociados. Si no se especifica, ClrAssembly utiliza los archivos existentes.

Si está establecido en ExpandFull, el elemento ObjectDefinition debería contener no solo la definición completa del objeto a modificar, sino también las definiciones de todos los objetos principales que son descendientes del objeto que se va a modificar.

[!NOTA]

El valor ExpandFull no se puede utilizar con el elemento Server.

Scope

(Atributo Enum opcional) Define la duración de objetos definido en el elemento ObjectDefinition.

Si se establece en Session, los objetos definidos en el elemento ObjectDefinition solamente existirán durante la sesión XMLA.

[!NOTA]

Si se utiliza el valor Session, el elemento ObjectDefinition solamente puede contener elementos ASSL Dimension, Cube o MiningModel.

Si se omite este atributo, los objetos definidos en el elemento ObjectDefinition se almacenan en la instancia de Analysis Services.

Comentarios

Cada comando Alter cambia la definición de un objeto principal situado bajo el objeto primario especificado por el elemento ParentObject.

Vea también

Conceptos

Comandos (XMLA)