Create 元素 (XMLA)

包含 Analysis Services 指令碼語言 (ASSL) 元素，這些專案是由 Execute 方法用來在 Analysis Services 實例上建立物件。

Syntax

  
<Command>  
   <Create Scope="enum" AllowOverwrite="boolean">  
      <ParentObject>...</ParentObject>  
      <ObjectDefinition>...</ObjectDefinition>  
   </Create>  
</Command>  

元素特性

特性	描述
資料類型和長度	None
預設值	None
基數	0-n：出現一次以上的選擇性元素。

元素關聯性

關聯性	元素
父元素	命令
子元素	ObjectDefinition、 ParentObject

屬性

屬性	描述
AllowOverwrite	選擇性 Boolean 屬性。 如果設定為 True， ObjectDefinition 元素中定義的物件可以覆寫 Analysis Services 實例上的現有物件。 如果這個屬性被省略或設定為 False，現有物件的存在就會產生錯誤。
範圍	選擇性的 列舉 屬性。 定義在 ObjectDefinition 元素中定義之物件的持續時間。 如果省略這個屬性， ObjectDefinition 元素中定義的物件會保存在 Analysis Services 實例上。 可用的值如下： 會話： ObjectDefinition 元素中定義的物件只存在於 XML for Analysis (XMLA) 會話的持續時間內。 請注意，使用 會話 設定時， ObjectDefinition 元素只能包含 維度、 Cube或 MiningModel ASSL 元素。

備註

每個 建立 作業都會在 ParentObject 元素所指定的父系下建立一個主要物件。 如果省略父物件，則會假設為目的地 Analysis Services 實例。 如果主要物件的父系不是目的地執行個體，這樣做就會產生錯誤。

範例

下列範例會在 Analysis Services 實例上建立名為 Test database 的空資料庫。

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