通过

Create 元素 (XMLA)

  • 项目

包含 Execute 方法在 Microsoft SQL Server Analysis Services 实例上创建对象时使用的 Analysis Services 脚本语言 (ASSL) 元素。

语法

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