Compartilhar via


Tarefa do Azure Data Lake Analytics

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

Com a tarefa do Azure Data Lake Analytics, é possível enviar trabalhos U-SQL para o serviço Azure Data Lake Analytics. Essa tarefa é um componente do feature pack para Azure do SSIS (SQL Server Integration Services).

Para obter informações gerais, consulte Azure Data Lake Analytics.

Important

O Azure Data Lake Analytics será desativado em 29 de fevereiro de 2024. Saiba mais nesse comunicado.

Configurar a tarefa

Para adicionar uma tarefa do Azure Data Lake Analytics a um pacote, arraste-a da Caixa de Ferramentas do SSIS para a tela do designer. Then double-click the task, or right-click the task and select Edit. A caixa de diálogo Editor de tarefas do Azure Data Lake Analytics é aberta. Você pode definir as propriedades por meio do Designer SSIS ou programaticamente.

Configuração de página geral

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

Basic configuration

É possível especificar o nome e a descrição da tarefa.

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. O script será enviado a uma conta do Azure Data Lake Analytics durante a execução do pacote do SSIS. As opções para essa propriedade são:

Value Description
DirectInput Especifica o script U-SQL por meio do editor embutido. Selecting this value displays the dynamic option, USQLStatement.
FileConnection Especifica um arquivo. usql local que contém o script U-SQL. Selecting this option displays the dynamic option, FileConnection.
Variable Especifica uma variável SSIS que contém o script U-SQL. Selecting this value displays the dynamic option, SourceVariable.

Opções Dinâmicas de SourceType especifica o conteúdo de script para a consulta U-SQL.

SourceType Dynamic Options
SourceType = DirectInput Digite a consulta U-SQL a ser enviada diretamente na caixa de opção ou selecione o botão Procurar (...) para digitar a consulta U-SQL na caixa de diálogo Digitar a consulta U-SQL.
SourceType = FileConnection Select an existing file connection manager, or select <New connection...> to create a new file connection. Para obter informações relacionadas, confira Gerenciador de Conexões de Arquivos e Editor do Gerenciador de Conexões de Arquivos.
SourceType = Variável Select an existing variable, or select <New variable...> to create a new variable. Para saber mais, confira Variáveis do SSIS (Integration Services) e Adicionar Variável.

Job configuration

A configuração de trabalho especifica as propriedades de envio do trabalho de U-SQL.

  • AzureDataLakeAnalyticsConnection: Specifies the Data Lake Analytics account where the U-SQL script is submitted. Escolha a conexão a partir de uma lista definida de gerenciadores de conexões. To create a new connection, select <New connection>. Para obter informações relacionadas, confira Gerenciador de Conexões do 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. Defina com um valor de 0 a 1000. Quanto menor o número, maior a prioridade.

  • RuntimeVersion: Specifies the Data Lake Analytics runtime version of the U-SQL job. Ele é definido como "padrão" por padrão. Normalmente, você não precisa alterar essa propriedade.

  • 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 O resultado da tarefa baseia-se no resultado de execução do trabalho U-SQL. Trabalho bem-sucedido > tarefa bem-sucedida. Falha do trabalho > falha na tarefa. Falha ou sucesso da tarefa > a tarefa é concluída.
    False O resultado da tarefa baseia-se no resultado de envio e preparação do trabalho U-SQL. Envio do trabalho bem-sucedido e fase de preparação realizada > tarefa bem-sucedida. Falha no envio do trabalho ou reprovação do trabalho na fase de preparação > falha na tarefa. Falha ou sucesso da tarefa > a tarefa é concluída.
  • TimeOut: Specifies a time-out time, in seconds, for job execution. Se o trabalho atingir o tempo limite, será cancelado e marcado como com falha. This property is not available if Synchronous is set to false.

Configuração de página de mapeamento de parâmetro

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. Para saber mais, confira Variáveis do SSIS (Integration Services).

  • Parameter Name: Provide a parameter/variable name in U-SQL script. Verifique se o nome do parâmetro começa com o sinal @, como @Param1.

Aqui está um exemplo de como passar parâmetros para o script U-SQL.

Exemplo de script 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

Configuração de página de expressão

É possível atribuir todas as propriedades na configuração de página Geral como uma expressão de propriedade para habilitar a atualização dinâmica da propriedade em runtime. Para obter informações relacionadas, confira Usar expressões de propriedade em pacotes.

See also