Elemento Alter (XMLA)

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

Sintassi

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

Caratteristiche degli elementi

Caratteristica	Descrizione
Tipo di dati e lunghezza	Nessuno
Valore predefinito	Nessuno
Cardinalità	0-n: Elemento facoltativo che può ricorrere più di una volta.

Relazioni tra elementi

Relazione	Elemento
Elementi padre	Comando
Elementi figlio	Object, ObjectDefinition

Attributi

Attributo	Descrizione
AllowCreate	(Attributo booleano 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 Analysis Services se non esistono già. In altre parole, il comando Alter viene considerato come un comando Create se gli oggetti non esistono già nell'istanza. Se questo attributo viene omesso o impostato su false, si verifica un errore se gli oggetti non esistono già.
ObjectExpansion	(Attributo Enum facoltativo) Definisce l'estensione della modifica che deve essere eseguita dal 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 usa 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 usa 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 usata 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 usa 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 resi persistenti nell Analysis Services istanza.

Commenti

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