共用方式為

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)