Create 요소(XMLA)Create Element (XMLA)

사용 하는 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 create objects on a MicrosoftMicrosoft SQL ServerSQL Server Analysis ServicesAnalysis Services instance.

구문Syntax


<Command>  
   <Create Scope="enum" AllowOverwrite="boolean">  
      <ParentObject>...</ParentObject>  
      <ObjectDefinition>...</ObjectDefinition>  
   </Create>  
</Command>  

요소 특징Element Characteristics

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

요소 관계Element Relationships

관계Relationship 요소Element
부모 요소Parent elements CommandCommand
자식 요소Child elements ObjectDefinition, ParentObjectObjectDefinition, ParentObject

특성Attributes

AttributeAttribute 설명Description
AllowOverwriteAllowOverwrite 선택적 Boolean 특성입니다.Optional Boolean attribute. 경우 True로 설정 된 개체에 정의 된는 ObjectDefinition 요소에서 기존 개체를 덮어쓸 수는 Analysis ServicesAnalysis Services 인스턴스.If set to True, the objects defined in the ObjectDefinition element can overwrite existing objects on the Analysis ServicesAnalysis Services instance. 이 특성이 생략되거나 False로 설정된 경우 기존 개체가 있으면 오류가 발생합니다.If this attribute is omitted or set to False, the presence of an existing object generates an error.
범위Scope 선택적 Enum 특성입니다.Optional Enum attribute. ObjectDefinition 요소에 정의된 개체의 지속 기간을 정의합니다.Defines the duration of objects defined in the ObjectDefinition element. 이 특성이 생략 된 경우 개체에 정의 된 ObjectDefinition 요소는 Analysis ServicesAnalysis Services 인스턴스.If this attribute is omitted, the objects defined in the ObjectDefinition element are persisted on the Analysis ServicesAnalysis Services instance. 다음 값을 사용할 수 있습니다.The following value is available:

세션:에 정의 된 개체는 ObjectDefinition 요소 Analysis (XMLA) 세션에 대 한 XML의 기간 동안만 존재 합니다.Session: The objects defined in the ObjectDefinition element exist only for the duration of the XML for Analysis (XMLA) session.
사용할 때의 세션 설정을 ObjectDefinition 요소만 포함할 수 있습니다 차원, 큐브, 또는 MiningModel ASSL 요소.Note that when using the Session setting, the ObjectDefinition element can only contain Dimension, Cube, or MiningModel ASSL elements.

주의Remarks

Create 작업은 ParentObject 요소에서 지정하는 부모 아래에 주요 개체 하나를 만듭니다.Each Create operation creates one major object under a parent given by the ParentObject element. 부모 개체가 생략된 경우 대상 Analysis ServicesAnalysis Services 인스턴스인 것으로 간주됩니다.If the parent object is omitted, it is assumed to be the destination Analysis ServicesAnalysis Services instance. 주요 개체의 부모가 대상 인스턴스가 아니면 오류가 발생합니다.This generates an error if the parent of a major object is not the destination instance.

예제Example

다음 예에서는 라는 빈 데이터베이스 테스트 데이터베이스Analysis ServicesAnalysis Services 인스턴스.The following example creates an empty database named Test Database on an Analysis ServicesAnalysis Services instance.


      <Create xmlns="http://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>  

관련 항목:See Also

명령 ( XMLA )Commands (XMLA)