Share via


Alter 요소(XMLA)

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

구문

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

요소 특성

특성 Description
데이터 형식 및 길이 None
기본값 None
카디널리티 0-n: 두 번 이상 나타날 수 있는 선택적 요소입니다.

요소 관계

관계 요소
부모 요소 명령
자식 요소 Object, ObjectDefinition

특성

attribute 설명
AllowCreate (선택적 부울 특성) 아직 없는 경우 Alter 명령에 정의된 개체를 만들어야 하는지 여부를 나타냅니다.

true로 설정하면 ObjectDefinition 요소에 정의된 개체가 아직 없는 경우 Analysis Services 인스턴스에 만들어집니다. 즉, 개체가 인스턴스에 아직 없는 경우 Alter 명령은 Create 명령으로 처리됩니다.

이 특성을 생략하거나 false로 설정하면 개체가 아직 없는 경우 오류가 발생합니다.
ObjectExpansion (선택적 열거형 특성) Execute 메서드에서 수행할 변경 범위를 정의합니다.

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

참고: ClrAssembly 데이터 형식과 함께 ObjectProperties 설정을 사용하는 경우 연결된 ClrAssemblyFile 데이터 형식의 데이터 요소를 지정할 필요가 없습니다. 지정하지 않으면 ClrAssembly 는 기존 파일을 사용합니다.

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

참고: ExpandFull 설정은 Server 요소와 함께 사용할 수 없습니다.
Scope (선택적 열거형 특성) ObjectDefinition 요소에 정의된 개체의 기간을 정의합니다.

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

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

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

설명

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