Create-Element (XMLA)

Artikel
05/08/2023

Enthält Analysis Services ASSL-Elemente (Scripting Language), die von der Execute-Methode zum Erstellen von Objekten auf einer Analysis Services-Instanz 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	Befehl
Untergeordnete Elemente	ObjectDefinition, ParentObject

Attribute

Attribut	BESCHREIBUNG
AllowOverwrite	Optionales boolesches Attribut. Wenn diese Einstellung auf True festgelegt ist, können die im ObjectDefinition-Element definierten Objekte 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.
Bereich	Optionales Enum -Attribut. Definiert die Dauer der Objekte, die im ObjectDefinition -Element definiert sind. Wenn dieses Attribut ausgelassen wird, werden die im ObjectDefinition-Element definierten Objekte auf der Analysis Services -Instanz beibehalten. Der folgende Wert ist verfügbar: Session: Die im ObjectDefinition-Element definierten Objekte sind nur für die Dauer der XML for Analysis (XMLA)-Sitzung vorhanden. Beachten Sie, dass das ObjectDefinition-Element bei Verwendung der Session-Einstellung nur Dimension-, Cube- oder MiningModel-ASSL-Elemente enthalten kann.

Attribut

BESCHREIBUNG

AllowOverwrite

Optionales boolesches Attribut. Wenn diese Einstellung auf True festgelegt ist, können die im ObjectDefinition-Element definierten Objekte 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.

Bereich

Optionales Enum -Attribut. Definiert die Dauer der Objekte, die im ObjectDefinition -Element definiert sind. Wenn dieses Attribut ausgelassen wird, werden die im ObjectDefinition-Element definierten Objekte auf der Analysis Services -Instanz beibehalten. Der folgende Wert ist verfügbar:

Session: Die im ObjectDefinition-Element definierten Objekte sind nur für die Dauer der XML for Analysis (XMLA)-Sitzung vorhanden.
Beachten Sie, dass das ObjectDefinition-Element bei Verwendung der Session-Einstellung nur Dimension-, Cube- oder MiningModel-ASSL-Elemente enthalten kann.

Hinweise

Jeder Create -Vorgang erstellt unter einem vom ParentObject -Element gegebenen übergeordneten Element ein Hauptobjekt. Wenn das übergeordnete Objekt ausgelassen wird, wird davon ausgegangen, dass es sich um das Ziel Analysis Services Instanz handelt. 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="http://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>

Share via