Create 요소(XMLA)

Execute 메서드가 MicrosoftSQL ServerAnalysis 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)