• Artikel

Create-Element (XMLA)

Enthält Analysis Services Scripting Language (ASSL)-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

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

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