• Artigo

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çãoObservaçã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çãoObservaçã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çãoObservaçã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)