共用方式為

  • 發行項

Create 元素 (XMLA)

包含「Analysis Services 指令碼語言」(ASSL) 元素，而這些元素可讓 Execute 方法用來建立 Microsoft SQL Server Analysis Services 執行個體上的物件。

語法

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

元素特性

特性

描述

資料類型和長度

無

預設值

無

基數

0-n：出現一次以上的選擇性元素。

元素關聯性

關聯性

元素

父元素

Command

子元素

ObjectDefinition、ParentObject

屬性

屬性

描述

AllowOverwrite

選擇性 Boolean 屬性。如果設定為 True，ObjectDefinition 元素中定義的物件就可以覆寫 Analysis Services 執行個體上的現有物件。如果這個屬性被省略或設定為 False，現有物件的存在就會產生錯誤。

Scope

選擇性 Enum 屬性。定義 ObjectDefinition 元素中定義之物件的持續時間。如果這屬性被省略，ObjectDefinition 元素中定義的物件就會保存在 Analysis Services 執行個體上。有下列可用的值：

  • Session

    ObjectDefinition 元素中定義的物件只會在 XML for Analysis (XMLA) 工作階段的持續時間內存在。

    附註附註
    當您使用 Session 設定時，ObjectDefinition 元素只能包含 Dimension、Cube 或 MiningModel ASSL 元素。

備註

每項 Create 作業都會在 ParentObject 元素提供的父系底下建立一個主要物件。如果您了省略父物件，它就會被假設為目的地 Analysis Services 執行個體。如果主要物件的父系不是目的地執行個體，這樣做就會產生錯誤。

範例

下列範例會在 Analysis Services 執行個體上建立名為 Test Database 的空白資料庫。

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

請參閱

概念

命令 (XMLA)