Elemento Alter (XMLA)
Contiene elementos del Lenguaje de scripts de Analysis Services (ASSL) utilizados por el método Execute para modificar objetos en una instancia de MicrosoftSQL ServerAnalysis Services.
Sintaxis
<Command>
<Alter Scope="enum" AllowCreate="boolean" ObjectExpansion="enum">
<Object>...</Object>
<ObjectDefinition>...</ObjectDefinition>
</Alter>
</Command>
Características del elemento
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 del elemento
Relación |
Elemento |
---|---|
Elementos primarios |
|
Elementos secundarios |
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 sólo 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 sólo existirán durante la sesión XMLA.
Nota
Si se utiliza el valor Session, el elemento ObjectDefinition sólo 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. |
Notas
Cada comando Alter cambia la definición de un objeto principal situado bajo el objeto primario especificado por el elemento ParentObject.