Analysis Services DDL 실행 태스크

아티클
07/12/2024

적용 대상: SQL Server Azure Data Factory의 SSIS Integration Runtime

Analysis Services DDL 실행 태스크는 마이닝 모델과 큐브 및 차원과 같은 다차원 개체를 만들거나 삭제하거나 변경할 수 있는 DDL(데이터 정의 언어) 문을 실행합니다. 예를 들어 DDL 문은 Adventure Works 큐브에 파티션을 만들거나 SQL Server에 포함된 샘플 Analysis Services 데이터베이스인 Adventure Works DW MultiDimension 2012에서 차원을 삭제할 수 있습니다.

Analysis Services DDL 실행 태스크는 Analysis Services 연결 관리자를 사용하여 Analysis Services 인스턴스 또는 Analysis Services 프로젝트에 연결합니다. 자세한 내용은 Analysis Services Connection Manager을 참조하세요.

Integration Services에는 분석 개체 처리, 데이터 마이닝 예측 쿼리 실행 등의 비즈니스 인텔리전스 작업을 수행하는 많은 태스크가 있습니다.

관련된 비즈니스 인텔리전스 태스크에 대한 자세한 내용을 보려면 다음 항목 중 하나를 클릭하세요.

DDL 문

DDL 문은 ASSL(Analysis Services Scripting Language) 문으로 표현되고 XMLA(XML for Analysis) 명령에 포함됩니다.

ASSL은 Analysis Services 인스턴스와 이 인스턴스에 포함된 데이터베이스 및 데이터베이스 개체를 정의하고 설명하는 데 사용됩니다. 자세한 내용은 Analysis Services 스크립팅 언어(XMLA용 ASSL)를 참조하세요.
XMLA는 Create, Alter 또는 Process와 같은 작업 명령을 Analysis Services 인스턴스로 보내는 데 사용되는 명령 언어입니다. 자세한 내용은 XMLA(XML for Analysis) 참조를 참조하세요.

DDL 코드가 별도의 파일에 저장되어 있을 경우 Analysis Services DDL 실행 태스크는 파일 연결 관리자를 사용하여 해당 파일의 경로를 지정합니다. 자세한 내용은 File Connection Manager를 참조하세요.

DDL 문은 암호와 기타 중요한 정보를 포함할 수 있으므로 Analysis Services DDL 실행 태스크가 하나 이상 포함된 패키지는 패키지 보호 수준 EncryptAllWithUserKey 또는 EncryptAllWithPassword를 사용해야 합니다. 자세한 내용은 Integration Services(SSIS) 패키지를 참조하세요.

DDL 예제

다음 세 개의 DDL 문은 SQL Server에 포함된 Analysis Services 데이터베이스인 Adventure Works DW Multidimensional 2012의 개체를 스크립팅하여 생성되었습니다.

다음 DDL 문은 Promotion 차원을 삭제합니다.

<Delete xmlns="http://schemas.microsoft.com/analysisservices/2003/engine">  
    <Object>  
        <DatabaseID>Adventure Works DW Multidimensional 2012</DatabaseID>  
        <DimensionID>Dim Promotion</DimensionID>  
    </Object>  
</Delete>

다음 DDL 문은 Adventure Works DW Multidimensional 2012 큐브를 처리합니다.

<Batch xmlns="http://schemas.microsoft.com/analysisservices/2003/engine">  
  <Parallel>  
    <Process xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">  
      <Object>  
        <DatabaseID>Adventure Works DW Multidimensional 2012</DatabaseID>  
      </Object>  
      <Type>ProcessFull</Type>  
      <WriteBackTableCreation>UseExisting</WriteBackTableCreation>  
    </Process>  
  </Parallel>  
</Batch>

다음 DDL 문은 예측 마이닝 모델을 만듭니다.

<Create xmlns="http://schemas.microsoft.com/analysisservices/2003/engine">  
    <ParentObject>  
        <DatabaseID>Adventure Works DW Multidimensional 2012</DatabaseID>  
        <MiningStructureID>Forecasting</MiningStructureID>  
    </ParentObject>  
    <ObjectDefinition>  
        <MiningModel xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">  
            <ID>Forecasting</ID>  
            <Name>Forecasting</Name>  
            <Algorithm>Microsoft_Time_Series</Algorithm>  
            <AlgorithmParameters>  
                <AlgorithmParameter>  
                    <Name>PERIODICITY_HINT</Name>  
                    <Value xsi:type="xsd:string">{12}</Value>  
                </AlgorithmParameter>  
            </AlgorithmParameters>  
            <Columns>  
                <Column>  
                    <ID>Amount</ID>  
                    <Name>Amount</Name>  
                    <SourceColumnID>Amount</SourceColumnID>  
                    <Usage>Predict</Usage>  
                </Column>  
                <Column>  
                    <ID>Model Region</ID>  
                    <Name>Model Region</Name>  
                    <SourceColumnID>Model Region</SourceColumnID>  
                    <Usage>Key</Usage>  
                </Column>  
                <Column>  
                    <ID>Quantity</ID>  
                    <Name>Quantity</Name>  
                    <SourceColumnID>Quantity</SourceColumnID>  
                    <Usage>Predict</Usage>  
                </Column>  
                <Column>  
                    <ID>Time Index</ID>  
                    <Name>Time Index</Name>  
                    <SourceColumnID>Time Index</SourceColumnID>  
                    <Usage>Key</Usage>  
                </Column>  
            </Columns>  
            <Collation>Latin1_General_CS_AS_KS</Collation>  
        </MiningModel>  
    </ObjectDefinition>  
</Create>

다음 세 개의 DDL 문은 SQL Server에 포함된 Analysis Services 데이터베이스인 Adventure Works DW Multidimensional 2012의 개체를 스크립팅하여 생성되었습니다.

다음 DDL 문은 Promotion 차원을 삭제합니다.

<Delete xmlns="http://schemas.microsoft.com/analysisservices/2003/engine">  
    <Object>  
        <DatabaseID>Adventure Works DW Multidimensional 2012</DatabaseID>  
        <DimensionID>Dim Promotion</DimensionID>  
    </Object>  
</Delete>

다음 DDL 문은 Adventure Works DW Multidimensional 2012 큐브를 처리합니다.

<Batch xmlns="http://schemas.microsoft.com/analysisservices/2003/engine">  
  <Parallel>  
    <Process xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">  
      <Object>  
        <DatabaseID>Adventure Works DW Multidimensional 2012</DatabaseID>  
      </Object>  
      <Type>ProcessFull</Type>  
      <WriteBackTableCreation>UseExisting</WriteBackTableCreation>  
    </Process>  
  </Parallel>  
</Batch>

다음 DDL 문은 예측 마이닝 모델을 만듭니다.

<Create xmlns="http://schemas.microsoft.com/analysisservices/2003/engine">  
    <ParentObject>  
        <DatabaseID>Adventure Works DW Multidimensional 2012</DatabaseID>  
        <MiningStructureID>Forecasting</MiningStructureID>  
    </ParentObject>  
    <ObjectDefinition>  
        <MiningModel xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">  
            <ID>Forecasting</ID>  
            <Name>Forecasting</Name>  
            <Algorithm>Microsoft_Time_Series</Algorithm>  
            <AlgorithmParameters>  
                <AlgorithmParameter>  
                    <Name>PERIODICITY_HINT</Name>  
                    <Value xsi:type="xsd:string">{12}</Value>  
                </AlgorithmParameter>  
            </AlgorithmParameters>  
            <Columns>  
                <Column>  
                    <ID>Amount</ID>  
                    <Name>Amount</Name>  
                    <SourceColumnID>Amount</SourceColumnID>  
                    <Usage>Predict</Usage>  
                </Column>  
                <Column>  
                    <ID>Model Region</ID>  
                    <Name>Model Region</Name>  
                    <SourceColumnID>Model Region</SourceColumnID>  
                    <Usage>Key</Usage>  
                </Column>  
                <Column>  
                    <ID>Quantity</ID>  
                    <Name>Quantity</Name>  
                    <SourceColumnID>Quantity</SourceColumnID>  
                    <Usage>Predict</Usage>  
                </Column>  
                <Column>  
                    <ID>Time Index</ID>  
                    <Name>Time Index</Name>  
                    <SourceColumnID>Time Index</SourceColumnID>  
                    <Usage>Key</Usage>  
                </Column>  
            </Columns>  
            <Collation>Latin1_General_CS_AS_KS</Collation>  
        </MiningModel>  
    </ObjectDefinition>  
</Create>

Analysis Services DDL 실행 태스크 구성

SSIS 디자이너를 사용하거나 프로그래밍 방식으로 속성을 설정할 수 있습니다.

SSIS 디자이너에서 설정할 수 있는 속성에 대한 자세한 내용은 다음 항목을 클릭하세요.

식 페이지

SSIS 디자이너에서 이러한 속성을 설정하는 방법을 보려면 다음 항목을 클릭하세요.

태스크 또는 컨테이너의 속성 설정

프로그래밍 방식으로 Analysis Services DDL 실행 태스크 구성

이러한 속성을 프로그래밍 방식으로 설정하는 방법을 보려면 다음 항목을 클릭하세요.

ASExecuteDDLTask

Analysis Services DDL 실행 태스크 편집기(일반 페이지)

Analysis Services DDL 실행 태스크 편집기 대화 상자의 일반 페이지를 사용하여 Analysis Services DDL 실행 태스크를 명명 및 설명할 수 있습니다.

옵션

이름
Analysis Services DDL 실행 태스크에 사용할 고유 이름을 제공합니다. 이 이름은 태스크 아이콘에서 레이블로 사용됩니다.

참고

태스크 이름은 패키지 내에서 고유해야 합니다.

설명
Analysis Services DDL 실행 태스크에 대한 설명을 입력합니다.

Analysis Services DDL 실행 태스크 편집기(DDL 페이지)

Analysis Services DDL 실행 태스크 편집기 대화 상자의 DDL 페이지를 사용하여 Analysis Services 프로젝트 또는 Analysis Services 데이터베이스에 대한 연결을 지정하고 DDL(데이터 정의 언어) 문의 원본에 대한 정보를 제공할 수 있습니다.

정적 옵션

Connection
목록에서 Analysis Services 프로젝트 또는 Analysis Services 연결 관리자를 선택하거나 <새 연결...>을 클릭한 다음, Analysis Services 연결 관리자 추가 대화 상자를 사용하여 새 연결을 만듭니다.

SourceType
DDL 문의 원본 유형을 지정합니다. 이 속성의 옵션은 다음 표에 나열되어 있습니다.

값	Description
직접 입력	원본을 SourceDirect 텍스트 상자에 저장된 DDL 문으로 설정합니다. 이 값을 선택하면 아래의 섹션에 동적 옵션이 표시됩니다.
파일 연결	원본을 DDL 문이 포함된 파일로 설정합니다. 이 값을 선택하면 아래의 섹션에 동적 옵션이 표시됩니다.
변수	소스를 변수로 설정합니다. 이 값을 선택하면 아래의 섹션에 동적 옵션이 표시됩니다.

동적 옵션

SourceType = 직접 입력

Source
DDL 문을 입력하거나 줄임표 (...)를 클릭한 다음 DDL 문 대화 상자에 문을 입력합니다.

SourceType = 파일 연결

Source
목록에서 파일 연결을 선택하거나 <새 연결...>을 클릭한 다음, 파일 연결 관리자 대화 상자를 사용하여 새 연결을 만듭니다.

관련 항목: 파일 연결 관리자

SourceType = Variable

Source
목록에서 변수를 선택하거나 <새 변수...>를 클릭한 다음, 변수 추가 대화 상자를 사용하여 새 변수를 만듭니다.

관련 항목: Integration Services(SSIS) 변수

다음을 통해 공유