Artikel
09/24/2010

Create-Element (XMLA)

Enthält Analysis Services Scripting Language (ASSL)-Elemente, die von der Execute-Methode zum Erstellen von Objekten auf einer MicrosoftSQL ServerAnalysis 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	Keine
Kardinalität	0-n: Optionales Element, das mehr als einmal auftreten kann.

Elementbeziehungen

Beziehung	Element
Übergeordnete Elemente	Command
Untergeordnete Elemente	ObjectDefinition, ParentObject

Attribute

Attribut	Beschreibung
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, verbleiben die im ObjectDefinition-Element definierten Objekte dauerhaft auf der Analysis Services-Instanz. 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.

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, verbleiben die im ObjectDefinition-Element definierten Objekte dauerhaft auf der Analysis Services-Instanz. 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)

Freigeben über