Elemento Alter (XMLA)

Artigo
08/01/2012

Contém elementos ASSL (Analysis Services Scripting Language) utilizados pelo método Execute para alterar objetos em uma instância de Microsoft SQL Server Analysis Services.

Sintaxe

<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 do elemento

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

Atributos

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.

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 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 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)

Compartilhar via