다음을 통해 공유

Alter 요소(XMLA)

  • 아티클

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

구문

<Command>
   <Alter Scope="enum" AllowCreate="boolean" ObjectExpansion="enum">
      <Object>...</Object>
      <ObjectDefinition>...</ObjectDefinition>
   </Alter>
</Command>

요소 특징

특징

설명

데이터 형식 및 길이

없음

기본값

없음

카디널리티

0-n: 두 번 이상 나타날 수 있는 선택적 요소입니다.

요소 관계

관계

요소

부모 요소

Command

자식 요소

Object, ObjectDefinition

특성

특성

설명

AllowCreate

선택적 Boolean 특성입니다. Alter 명령에 정의된 개체가 아직 존재하지 않는 경우 해당 개체를 만들어야 하는지 여부를 나타냅니다.

True로 설정하면 ObjectDefinition 요소에 정의된 개체가 아직 존재하지 않는 경우 Analysis Services 인스턴스에서 생성됩니다. 즉, 개체가 아직 해당 인스턴스에 없는 경우 Alter 명령은 Create 명령으로 처리됩니다.

이 특성을 생략하거나 false로 설정하면 개체가 아직 존재하지 않는 경우 오류가 발생합니다.

ObjectExpansion

선택적 Enum 특성입니다. Execute 메서드로 수행할 변경의 범위를 정의합니다.

ObjectProperties로 설정하면 ObjectDefinition 요소가 하위 보조 개체를 비롯하여 변경할 주요 개체의 전체 정의만 포함해야 합니다. 변경할 개체의 하위 주요 개체는 변경되지 않은 상태로 유지됩니다.

[!참고]

ClrAssembly 데이터 형식에 ObjectProperties 설정을 사용하는 경우 연결된 ClrAssemblyFile 데이터 형식의 Data 요소를 지정할 필요가 없습니다. 지정하지 않은 경우 ClrAssembly는 기존 파일을 사용합니다.

ExpandFull로 설정하면 ObjectDefinition 요소는 변경할 개체의 정의뿐만 아니라 변경할 개체의 하위 항목인 모든 주요 개체의 정의도 포함해야 합니다.

[!참고]

Server 요소에는 ExpandFull 설정을 사용할 수 없습니다.

Scope

선택적 Enum 특성입니다. ObjectDefinition 요소에 정의된 개체의 기간을 정의합니다.

Session으로 설정하면 ObjectDefinition 요소에 정의된 개체가 XMLA 세션 기간 동안만 존재합니다.

[!참고]

Session 설정을 사용하는 경우 ObjectDefinition 요소는 Dimension, Cube 또는 MiningModel ASSL 요소만 포함할 수 있습니다.

이 특성을 생략하면 ObjectDefinition 요소에 정의된 개체가 Analysis Services 인스턴스에서 지속됩니다.

주의

각 Alter 명령은 ParentObject 요소로 지정된 부모 개체 아래에 있는 주요 개체 하나의 정의를 변경합니다.

참고 항목

개념

명령(XMLA)