Create 요소(XMLA)

Execute 메서드가 Microsoft SQL Server Analysis Services 인스턴스에서 개체를 만들 때 사용하는 ASSL(Analysis Services Scripting Language) 요소를 포함합니다.

구문

<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 요소에 정의된 개체가 XMLA(XML for Analysis) 세션이 지속되는 동안에만 존재합니다.

    [!참고]

    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)