Elemento Alter (XMLA)

Contém elementos ASSL (Analysis Services Scripting Language) utilizados pelo método Execute para alterar objetos em uma instância do MicrosoftSQL ServerAnalysis Services.

Sintaxe

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

Características do elemento

Característica	Descrição
Tipo e comprimento dos dados	Nenhum
Valor padrão	Nenhum
Cardinalidade	0-n: elemento opcional que pode ocorrer mais de uma vez.

Relação do elemento

Relação	Elemento
Elementos pai	Command
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 for definido como True, os objetos definidos no elemento ObjectDefinition serão criados na instância do 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.
Scope	(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 Session, o elemento ObjectDefinition só pode conter os elementos Dimension, Cubeou MiningModel de ASSL. Se este atributo for omitido, os objetos definidos no elemento ObjectDefinition persistirão na instância do Analysis Services.

Comentários

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

Consulte também

Conceitos

Commands (XMLA)