Elemento Alter (XMLA)

Contiene elementi ASSL (Analysis Services Scripting Language) utilizzati dal metodo Execute per modificare 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
Elemento 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. [!NOTA] 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. [!NOTA] 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. [!NOTA] 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)