다음을 통해 공유


Azure Data Lake Analytics 태스크

Applies to:SQL Server SSIS Integration Runtime in Azure Data Factory

Data Lake Analytics 태스크를 사용하면 사용자가 U-SQL 작업을 Azure Data Lake Analytics 서비스에 제출할 수 있습니다. 이 태스크는 Azure용 SQL Server Integration Services(SSIS) 기능 팩의 구성 요소입니다.

일반적인 배경은 Azure Data Lake Analytics를 참조하세요.

Important

Azure Data Lake Analytics는 2024년 2월 29일에 사용 중지될 예정입니다. 이 공지 사항을 통해 자세히 알아봅니다.

태스크 구성

패키지에 Data Lake Analytics 태스크를 추가하려면 SSIS 도구 상자에서 디자이너 캔버스로 끕니다. Then double-click the task, or right-click the task and select Edit. Azure Data Lake Analytics 태스크 편집기 대화 상자가 열립니다. SSIS 디자이너를 사용하거나 프로그래밍 방식으로 속성을 설정할 수 있습니다.

일반 페이지 구성

Use the General page to configure the task and provide the U-SQL script that the task submits.

Basic configuration

태스크의 이름 및 설명을 지정할 수 있습니다.

U-SQL configuration

U-SQL configuration has two settings: SourceType, and dynamic options based on the SourceType value.

SourceType specifies the source of the U-SQL script. SSIS 패키지 실행 중에 Data Lake Analytics 계정에 스크립트가 제출됩니다. 이 속성의 옵션은 다음과 같습니다.

Value Description
DirectInput 인라인 편집기를 통해 U-SQL 스크립트를 지정합니다. Selecting this value displays the dynamic option, USQLStatement.
FileConnection U-SQL 스크립트를 포함하는 로컬 .usql 파일을 지정합니다. Selecting this option displays the dynamic option, FileConnection.
Variable U-SQL 스크립트를 포함하는 SSIS 변수를 지정합니다. Selecting this value displays the dynamic option, SourceVariable.

SourceType 동적 옵션은 U-SQL 쿼리에 대한 스크립트 콘텐츠를 지정합니다.

SourceType Dynamic Options
SourceType = DirectInput 옵션 상자에 직접 제출할 U-SQL 쿼리를 입력하거나 찾아보기 단추(...)를 선택하여 U-SQL 쿼리 입력 대화 상자에 U-SQL 쿼리를 입력합니다.
SourceType = FileConnection Select an existing file connection manager, or select <New connection...> to create a new file connection. 관련 내용은 파일 연결 관리자파일 연결 관리자 편집기를 참조하세요.
SourceType = 변수 Select an existing variable, or select <New variable...> to create a new variable. 관련 내용은 Integration Services(SSIS) 변수변수 추가를 참조하세요.

Job configuration

작업 구성은 U-SQL 작업 제출 속성을 지정합니다.

  • AzureDataLakeAnalyticsConnection: Specifies the Data Lake Analytics account where the U-SQL script is submitted. 정의된 연결 관리자 목록에서 연결을 선택합니다. To create a new connection, select <New connection>. 관련 내용은 Azure Data Lake Analytics 연결 관리자를 참조하세요.

  • JobName: Specifies the name of the U-SQL job.

  • AnalyticsUnits: Specifies the analytics unit count of the U-SQL job.

  • Priority: Specifies the priority of the U-SQL job. 이 항목은 0~1000 사이의 값으로 설정할 수 있습니다. 번호가 낮을수록 우선 순위가 높습니다.

  • RuntimeVersion: Specifies the Data Lake Analytics runtime version of the U-SQL job. 기본적으로"기본값"이 설정됩니다. 일반적으로는 이 속성을 변경할 필요가 없습니다.

  • Synchronous: A Boolean value specifies if the task waits for the job execution to complete or not. If the value is set to true, the task is marked as succeed after the job completes. If the value is set to false, the task is marked as succeed after the job passes the preparation phase.

    Value Description
    True 태스크 결과는 U-SQL 작업 실행 결과를 기반으로 합니다. 작업 성공 > 태스크 성공. 작업 실패 > 태스크 실패. 태스크 성공 또는 실패 > 태스크 완료.
    False 태스크 결과는 U-SQL 작업 제출 및 준비 결과를 기반으로 합니다. 작업 제출 성공 및 준비 단계 통과 > 태스크 성공. 작업 제출 실패 또는 준비 단계에서 작업 실패 > 태스크 실패. 태스크 성공 또는 실패 > 태스크 완료.
  • TimeOut: Specifies a time-out time, in seconds, for job execution. 작업이 시간 초과되면 취소되고 실패한 것으로 표시됩니다. This property is not available if Synchronous is set to false.

매개 변수 매핑 페이지 구성

Use the Parameter Mapping page of the Azure Data Lake Analytics Task Editor dialog box to map variables to parameters (U-SQL variables) in U-SQL script.

  • Variable Name: After you have added a parameter mapping by selecting Add, select a system or user-defined variable from the list. Alternatively, you can select <New variable...> to add a new variable by using the Add Variable dialog box. 관련 내용은 Integration Services(SSIS) 변수를 참조하세요.

  • Parameter Name: Provide a parameter/variable name in U-SQL script. 매개 변수 이름이 @Param1과 같이 @ 기호로 시작하는지 확인합니다.

다음은 U-SQL 스크립트에 매개 변수를 전달하는 방법의 예입니다.

샘플 U-SQL 스크립트

@searchlog =
    EXTRACT UserId          int,
            Start           DateTime,
            Region          string,
            Query           string,
            Duration        int,
            Urls            string,
            ClickedUrls     string
    FROM @in
    USING Extractors.Tsv(nullEscape:"#NULL#");

@rs1 =
    SELECT Start, Region, Duration
    FROM @searchlog
WHERE Region == "en-gb";

@rs1 =
    SELECT Start, Region, Duration
    FROM @rs1
    WHERE Start <= DateTime.Parse("2012/02/19");

OUTPUT @rs1   
    TO @out
      USING Outputters.Tsv(quoting:false, dateTimeFormat:null);

Note that the input and output paths are defined in @in and @out parameters. The values for @in and @out parameters in the U-SQL script are passed dynamically by the parameter mapping configuration.

Variable name Parameter name
User: Variable1 @in
User: Variable2 @out

식 페이지 구성

일반 페이지 구성의 모든 속성을 속성 식으로 할당하여 런타임에 속성을 동적으로 업데이트할 수 있습니다. 자세한 내용은 패키지에서 속성 식 사용을 참조하세요.

See also