Share via

Create 要素 (XMLA)

  • [アーティクル]

Microsoft SQL Server 2005 Analysis Services (SSAS) インスタンス上にオブジェクトを作成するために Execute メソッドによって使用される Analysis Services Scripting Language (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) セッションの期間だけ存続します。
    ms187134.note(ja-jp,SQL.90).gifメモ :

解説

各 Create 操作は、ParentObject 要素によって指定される親の下に 1 つの主要なオブジェクトを作成します。親オブジェクトが省略された場合、作成先の Analysis Services インスタンスと見なされます。主要なオブジェクトの親が作成先のインスタンスでない場合には、これによってエラーが発生します。

使用例

次の例は、Test Database という名前の空のデータベースを Analysis Services インスタンス上に作成します。

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

ヘルプおよび情報

SQL Server 2005 の参考資料の入手