Compartilhar via


Elemento Alter (XMLA)

Contém Analysis Services elementos ASSL usados pelo método Execute para alterar objetos em uma instância do Analysis Services.

Syntax

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

Características do elemento

Característica Descrição
Comprimento e tipo de dados Nenhum
Valor padrão Nenhum
Cardinalidade 0-n: Elemento opcional que pode ocorrer mais de uma vez.

Relações de elemento

Relação Elemento
Elementos pai Comando
Elementos filho Object, ObjectDefinition

Atributos

Atributo Descrição
AllowCreate (Atributo Boolean opcional) Indica se os objetos definidos no comando Alter devem ser criados se ainda não existirem.

Se definido como true, os objetos definidos no elemento ObjectDefinition serão criados na instância Analysis Services se ainda não existirem. Em outras palavras, o comando Alter é tratado como um comando Create se os objetos ainda não existirem na instância.

Se esse atributo for omitido ou definido como false, ocorrerá um erro se os objetos ainda não existirem.
ObjectExpansion (Atributo Enum opcional) Define a extensão da alteração a ser executada pelo método Execute .

Se for definido como ObjectProperties, o elemento ObjectDefinition deve conter somente a definição completa do principal objeto a ser alterado, incluindo os objetos menores subordinados. Os objetos grandes subordinados ao objeto a ser alterado permanecem iguais.

Observação: ao usar a configuração ObjectProperties com o tipo de dados ClrAssembly , o elemento Data dos tipos de dados ClrAssemblyFile associados não precisa ser especificado. Se não for especificado, o elemento ClrAssembly usará os arquivos existentes.

Se for definido como ExpandFull, o elemento ObjectDefinition não deve conter apenas a definição do objeto a ser alterado, mas também as definições de todos os principais objetos que são descendentes do objeto a ser alterado.

Observação: a configuração ExpandFull não pode ser usada com o elemento Server.
Escopo (Atributo Enum opcional) Define a duração dos objetos definidos no elemento ObjectDefinition .

Se for definido como Session, os objetos definidos no elemento ObjectDefinition existirão somente durante a sessão XMLA.

Observação: ao usar a configuração Sessão , o elemento ObjectDefinition só pode conter elementos ASSL Dimension, Cube ou MiningModel .

Se esse atributo for omitido, os objetos definidos no elemento ObjectDefinition serão persistentes na Analysis Services instância.

Comentários

Cada comando Alter altera a definição de um objeto principal sob o objeto pai especificado pelo elemento ParentObject .