• Artikel

Alter-Element (XMLA)

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

Keine

Kardinalität

0-n: Optionales Element, das mehr als einmal auftreten kann.

Elementbeziehungen

Beziehung

Element

Übergeordnete Elemente

Command

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.

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.

HinweisHinweis
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.

HinweisHinweis
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.

HinweisHinweis
Wenn es die Session-Einstellung verwendet, kann das ObjectDefinition-Element nur Dimension-, Cube- oder MiningModel-ASSL-Elemente enthalten.

Wenn dieses Attribut weggelassen wird, verbleiben die im ObjectDefinition-Element definierten Objekte dauerhaft auf der Analysis Services-Instanz.

Hinweise

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

Siehe auch

Konzepte

Befehle (XMLA)