• Articolo

Elemento Alter (XMLA)

Contiene elementi ASSL (Analysis Services Scripting Language) utilizzati dal metodo Execute per modificare gli oggetti in un'istanza di Microsoft SQL Server Analysis Services.

Sintassi

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

Caratteristiche elemento

Caratteristica

Descrizione

Tipo di dati e lunghezza

Nessuno

Valore predefinito

Nessuno

Cardinalità

0-n: elemento facoltativo che può ricorrere più di una volta.

Relazioni elemento

Relazione

Elemento

Elementi padre

Command

Elementi figlio

Object, ObjectDefinition

Attributi

Attributo

Descrizione

AllowCreate

(Attributo Boolean facoltativo) Indica se gli oggetti definiti nel comando Alter devono essere creati se non esistono già.

Se è impostato su True, gli oggetti definiti nell'elemento ObjectDefinition vengono creati nell'istanza di Analysis Services, se non esistono già. In altre parole, il comando Alter viene trattato come comando Create se gli oggetti non esistono già nell'istanza.

Se l'attributo viene omesso o impostato su false, se gli oggetti non esistono già si verifica un errore.

ObjectExpansion

(Attributo Enum facoltativo) Definisce l'ambito della modifica che deve essere eseguita tramite il metodo Execute.

Se è impostato su ObjectProperties, l'elemento ObjectDefinition deve contenere solo la definizione completa dell'oggetto principale da modificare, inclusi gli oggetti secondari subordinati. Gli oggetti principali subordinati dell'oggetto da modificare non vengono modificati.

NotaNota
Quando si utilizza l'impostazione ObjectProperties con il tipo di dati ClrAssembly, l'elemento Data dei tipi di dati ClrAssemblyFile associati non deve essere specificato. Se non è specificato, ClrAssembly utilizza i file esistenti.

Se è impostato su ExpandFull, l'elemento ObjectDefinition deve contenere non solo la definizione dell'oggetto da modificare, ma anche le definizioni di tutti gli oggetti principali discendenti dell'oggetto da modificare.

NotaNota
L'impostazione ExpandFull non può essere utilizzata con l'elemento Server.

Scope

(Attributo Enum facoltativo) Definisce la durata degli oggetti definiti nell'elemento ObjectDefinition.

Se è impostato su Session, gli oggetti definiti nell'elemento ObjectDefinition esistono solo per la durata della sessione XMLA.

NotaNota
Quando si utilizza l'impostazione Session, l'elemento ObjectDefinition può contenere solo elementi ASSL Dimension, Cube o MiningModel.

Se questo attributo viene omesso, gli oggetti definiti nell'elemento ObjectDefinition vengono conservati in modo permanente nell'istanza di Analysis Services.

Osservazioni

Ogni comando Alter modifica la definizione di un oggetto principale nell'oggetto padre specificato dall'elemento ParentObject.

Vedere anche

Concetti

Comandi (XMLA)