Elemento Alter (XMLA)

Contiene Analysis Services de Scripting Language (ASSL) usados por el método Execute para modificar objetos en una instancia de 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 aparecer más de una vez.

Relaciones de elementos

Relación	Elemento
Elementos primarios	Comando
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 se establece en true, los objetos definidos en el elemento ObjectDefinition se crean en la 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: Cuando se usa el valor ObjectProperties con el tipo de datos 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 usar con el elemento Server .
Ámbito	(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: Cuando se usa el valor Session , el elemento ObjectDefinition solo puede contener elementos DIMENSION, Cube o MiningModel ASSL. Si se omite este atributo, los objetos definidos en el elemento ObjectDefinition se conservan en la Analysis Services predeterminada.

Comentarios

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