Create-Element (XMLA)

Artikel
08/01/2012

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

Syntax

<Command>
   <Create Scope="enum" AllowOverwrite="boolean">
      <ParentObject>...</ParentObject>
      <ObjectDefinition>...</ObjectDefinition>
   </Create>
</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	ObjectDefinition, ParentObject

Attribute

AllowOverwrite

Optionales Boolean-Attribut. Bei Festlegung auf "True" können die Objekte, die im ObjectDefinition-Element definiert werden, vorhandene Objekte auf der Analysis Services-Instanz überschreiben. Wenn dieses Attribut weggelassen oder auf "False" gesetzt wird, generiert das Vorhandensein eines existierenden Objekts einen Fehler.

Scope

Optionales Enum-Attribut. Definiert die Dauer der Objekte, die im ObjectDefinition-Element definiert sind. Wenn dieses Attribut weggelassen wird, werden die im ObjectDefinition-Element definierten Objekte persistent auf der Analysis Services-Instanz gespeichert. Die folgenden Werte sind verfügbar:

Session

Die im ObjectDefinition-Element definierten Objekte existieren nur während der Dauer der XMLA-Sitzung (XML for Analysis).

Hinweis

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

Hinweise

Jeder Create-Vorgang erstellt unter einem vom ParentObject-Element gegebenen übergeordneten Element ein Hauptobjekt. Wenn das übergeordnete Objekt weggelassen wird, wird davon ausgegangen, dass es die Ziel-Analysis Services-Instanz ist. Dies generiert einen Fehler, wenn das übergeordnete Element eines Hauptobjekts nicht die Zielinstanz ist.

Beispiel

Im folgenden Beispiel wird eine leere Datenbank mit dem Namen Test Database auf einer Analysis Services-Instanz erstellt.

<Create xmlns="https://schemas.microsoft.com/analysisservices/2003/engine">
   <ObjectDefinition>
      <Database xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
         <Name>Test Database</Name>
         <Description>A test database.</Description>
      </Database>
   </ObjectDefinition>
</Create>

Siehe auch

Konzepte

Befehle (XMLA)

Share via