Alter-Element (XMLA)

Artikel
08/01/2012

Enthält Analysis Services Scripting Language (ASSL)-Elemente, die von der Execute-Methode zum Ändern einer Instanz von Microsoft SQL Server Analysis Services verwendet werden.

Syntax

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

Elementmerkmale

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

Elementbeziehungen

Beziehung	Element
Übergeordnete Elemente	Befehl
Untergeordnete Elemente	Object, ObjectDefinition

Attribute

AllowCreate

(Optionales Boolean-Attribut) Gibt an, ob Objekte, die im Alter-Befehl definiert werden, erstellt werden sollten, wenn sie bisher noch nicht vorhanden sind.

Bei Festlegung auf "True" werden die Objekte, die in ObjectDefinition definiert werden, auf der Analysis Services-Instanz erstellt, sofern sie nicht bereits 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 false gesetzt 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
Bei Verwendung der ObjectProperties-Einstellung mit dem ClrAssembly-Datentyp 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 für das Server-Element verwendet werden.

Scope

(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
Wenn es die Session-Einstellung verwendet, kann das ObjectDefinition-Element nur Dimension-, Cube- oder MiningModel-ASSL-Elemente enthalten.

Wenn dieses Attribut weggelassen wird, werden die im ObjectDefinition-Element definierten Objekte persistent auf der Analysis Services-Instanz gespeichert.

Hinweise

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

Siehe auch

Konzepte

Befehle (XMLA)

Freigeben über