Create 元素 (XMLA)

包含Analysis Services脚本语言 (ASSL) Execute 方法用于在实例上创建对象Analysis Services元素。

语法

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

元素特征

特征 说明
数据类型和长度 无
默认值 无
基数 0-n:可多次出现的可选元素。

元素关系

关系 元素
父元素 命令
子元素 ObjectDefinition、 ParentObject

属性

属性 说明
AllowOverwrite 可选的 布尔 属性。 如果设置为 True, 则 ObjectDefinition 元素中定义的对象可以覆盖该实例Analysis Services对象。 如果忽略此属性或将其设置为 False,则存在现有对象时将生成一个错误。
范围 可选的 枚举 属性。 定义 ObjectDefinition 元素中定义的对象的持续时间。 如果省略此属性, ObjectDefinition 元素中定义的对象将持久保存Analysis Services实例。 以下值可用:

会话: ObjectDefinition 元素中定义的对象仅在 XMLA XML for Analysis (会话) 存在。
请注意,使用 Session 设置 时 , ObjectDefinition 元素只能包含 Dimension、 Cube 或 MiningModel ASSL 元素。

备注

每个 创建 操作在 ParentObject 元素给定的父级下创建一个主要对象。 如果省略父对象,则假定它是实例Analysis Services目标。 如果主要对象的父级不是目标实例,则会产生错误。

示例

以下示例在实例上创建名为 Test Database 的Analysis Services数据库。

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