Alter 요소(XMLA)Alter Element (XMLA)

적용 대상:예SQL Server Analysis Services예Azure Analysis ServicesAPPLIES TO:yesSQL Server Analysis ServicesyesAzure Analysis Services사용 하는 Analysis Services Scripting Language (ASSL) 요소를 포함 된 Execute 개체의 인스턴스를 변경 하려면 MicrosoftMicrosoft SQL ServerSQL Server Analysis ServicesAnalysis Services합니다. Contains Analysis Services Scripting Language (ASSL) elements used by the Execute method to alter objects on an instance of MicrosoftMicrosoft SQL ServerSQL Server Analysis ServicesAnalysis Services.

구문Syntax


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

요소 특징Element Characteristics

특징Characteristic DescriptionDescription
데이터 형식 및 길이Data type and length InclusionThresholdSettingNone
기본값Default value InclusionThresholdSettingNone
카디널리티Cardinality 0-n: 두 번 이상 나타날 수 있는 선택적 요소입니다.0-n: Optional element that can occur more than once.

요소 관계Element Relationships

관계Relationship 요소Element
부모 요소Parent elements CommandCommand
자식 요소Child elements 개체, ObjectDefinitionObject, ObjectDefinition

특성Attributes

attributeAttribute DescriptionDescription
AllowCreateAllowCreate (선택 사항 부울 특성)에 정의 된 개체가 있는지 여부를 나타내는 Alter 존재 하지 않을 경우 명령을 만들어야 합니다.(Optional Boolean attribute) Indicates whether objects defined in the Alter command should be created if they do not already exist.

경우에 정의 된 개체를 true로 설정 된 ObjectDefinition 요소에 생성 됩니다는 Analysis ServicesAnalysis Services 이미 존재 하지 않는 경우 인스턴스.If set to true, the objects defined in the ObjectDefinition element are created on the Analysis ServicesAnalysis Services instance if they do not already exist. 즉,는 Alter 명령으로 처리 됩니다는 만들기 경우는 개체가 존재 하지 않는 이미 인스턴스에서 명령입니다.In other words, the Alter command is treated as a Create command if the objects do not already exist on the instance.

이 특성이 생략 되거나로 설정 된 경우 false, 개체가 아직 존재 하지 않는 경우 오류가 발생 합니다.If this attribute is omitted or set to false, an error occurs if the objects do not already exist.
ObjectExpansionObjectExpansion (선택 사항 열거형 특성)에서 수행할 변경의 범위를 정의 고 Execute 메서드.(Optional Enum attribute) Defines the extent of alteration to be performed by the Execute method.

경우로 설정 ObjectProperties, ObjectDefinition 요소 포함 되어야 변경, 주요 개체의 전체 정의 하위 보조 개체를 포함 합니다.If set to ObjectProperties, the ObjectDefinition element should contain only the complete definition of the major object to be altered, including subordinate minor objects. 변경할 개체의 하위 주요 개체는 변경되지 않은 상태로 유지됩니다.Subordinate major objects of the object to be altered remain unchanged.

참고: 사용 하는 경우는 ObjectProperties 사용 하 여 설정 된 ClrAssembly 데이터 형식으로는 데이터 관련 된 요소 ClrAssemblyFile 데이터 형식을 지정할 필요가 없습니다.Note: When using the ObjectProperties setting with the ClrAssembly data type, the Data element of the associated ClrAssemblyFile data types does not need to be specified. 지정 하지 않으면는 ClrAssembly 기존 파일을 사용 합니다.If not specified, the ClrAssembly uses existing files.

경우 설정 ExpandFull, ObjectDefinition 요소 뿐 아니라 변경, 개체의 정의 뿐만 아니라 개체의 하위 항목인 모든 주요 개체의 정의 포함 되어야 변경 합니다.If set to ExpandFull, the ObjectDefinition element should contain not just the definition of the object to be altered, but also the definitions of all major objects which are descendants of the object to be altered.

참고:는 ExpandFull 설정은 함께 사용할 수 없습니다는 서버 요소입니다.Note: The ExpandFull setting cannot be used with the Server element.
범위Scope (선택 사항 Enum 특성)에 정의 된 개체의 기간을 정의 ObjectDefinition 요소입니다.(Optional Enum attribute) Defines the duration of objects defined in the ObjectDefinition element.

경우로 설정 세션에 정의 된 개체는 ObjectDefinition 요소 XMLA 세션 기간 동안만 존재 합니다.If set to Session, the objects defined in the ObjectDefinition element exist only for the duration of the XMLA session.

참고: 사용 하는 경우는 세션 설정을 ObjectDefinition 요소만 포함할 수 있습니다 차원, 큐브, 또는 MiningModel ASSL 요소.Note: When using the Session setting, the ObjectDefinition element can only contain Dimension, Cube, or MiningModel ASSL elements.

이 특성이 생략 된 경우 개체에 정의 된 ObjectDefinition 요소는 Analysis ServicesAnalysis Services 인스턴스.If this attribute is omitted, the objects defined in the ObjectDefinition element are persisted on the Analysis ServicesAnalysis Services instance.

주의Remarks

Alter 명령으로 지정 된 부모 개체 아래로 주요 개체 하나의 정의 변경 합니다.는 ParentObject 요소입니다.Each Alter command changes the definition of one major object under the parent object specified by the ParentObject element.

관련 항목:See Also

명령 ( XMLA )Commands (XMLA)