Alter-Element (XMLA)

Enthält Analysis Services ASSL-Elemente (Scripting Language), die von der Execute-Methode verwendet werden, um Objekte auf einer Instanz von Analysis Services.

Syntax

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

Elementmerkmale

Merkmal	BESCHREIBUNG
Datentyp und -länge	Keine
Standardwert	Keine
Kardinalität	0-n: Optionales Element, das mehr als einmal auftreten kann.

Elementbeziehungen

Beziehung	Element
Übergeordnete Elemente	Befehl
Untergeordnete Elemente	Object, ObjectDefinition

Attribute

Attribut	BESCHREIBUNG
AllowCreate	(Optionales Boolean -Attribut) Gibt an, ob Objekte, die im Alter -Befehl definiert werden, erstellt werden sollten, wenn sie bisher noch nicht vorhanden sind. Wenn diese Eigenschaft auf TRUE festgelegt ist, werden die im ObjectDefinition-Element definierten Objekte auf der Analysis Services erstellt, sofern sie noch nicht vorhanden sind. Mit anderen Worten: Der Alter -Befehl wird wie ein Create -Befehl behandelt, wenn die Objekte noch nicht auf der Instanz vorhanden sind. Wenn dieses Objekt ausgelassen oder auf falsegesetzt wird, tritt ein Fehler auf, wenn die Objekte noch nicht vorhanden sind.
ObjectExpansion	(Optionales Enum -Attribut) Definiert den Umfang der Änderung, die von der Execute -Methode ausgeführt werden soll. Wenn das ObjectDefinition-Element auf ObjectProperties festgelegt ist, sollte es nur die vollständige Definition des zu ändernden Hauptobjekts, einschließlich seiner untergeordneten Nebenobjekte, enthalten. Untergeordnete Hauptobjekte des Objekts, die geändert werden sollen, bleiben unverändert. Hinweis: Wenn Sie die ObjectProperties-Einstellung mit dem ClrAssembly-Datentyp verwenden, muss das Data-Element der zugeordneten ClrAssemblyFile-Datentypen nicht angegeben werden. Sofern keine Angabe gemacht wird, verwendet ClrAssembly vorhandene Dateien. Wenn das ObjectDefinition-Element auf ExpandFull festgelegt ist, sollte es nicht nur die Definition des zu ändernden Objekts enthalten, sondern auch die Definitionen aller Hauptobjekte, die Nachkommen des zu ändernden Objekts sind. Hinweis: Die ExpandFull-Einstellung kann nicht mit dem Server-Element verwendet werden.
Bereich	(Optionales Enum -Attribut) Definiert die Lebenszeit der Objekte, die im ObjectDefinition -Element definiert sind. Wenn die im ObjectDefinition-Element definierten Objekte auf Session festgelegt sind, ist das Element nur für die Dauer der XMLA-Sitzung vorhanden. Hinweis: Bei Verwendung der Session-Einstellung darf das ObjectDefinition-Element nur ASSL-Elemente vom Element Dimension, Cube oder MiningModel enthalten. Wenn dieses Attribut weggelassen wird, werden die im ObjectDefinition-Element definierten Objekte auf der Analysis Services beibehalten.

Hinweise

Jeder Alter -Befehl ändert die Definition eines Hauptobjekts unter dem übergeordneten Objekt, das vom ParentObject -Element festgelegt wird.