Tarefa do Azure Data Lake Analytics

Aplica-se a: SQL Server SSIS Integration Runtime no 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.

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. Clique duas vezes na tarefa, ou clique com o botão direito na tarefa, e selecione Editar. 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 a página Geral para configurar a tarefa e fornecer o script U-SQL que a tarefa envia. Para saber mais sobre a linguagem U-SQL, confira Referência da linguagem U-SQL.

Configuração básica

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

Configuração do U-SQL

A configuração de U-SQL tem duas configurações: SourceType e as opções dinâmicas com base no valor de SourceType.

SourceType especifica a origem do script U-SQL. 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:

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

Configuração do trabalho

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

• AzureDataLakeAnalyticsConnection: Especifica a conta do Data Lake Analytics em que o script U-SQL é enviado. Escolha a conexão a partir de uma lista definida de gerenciadores de conexões. Para criar uma nova conexão, selecione <Nova conexão>. Para obter informações relacionadas, confira Gerenciador de Conexões do Azure Data Lake Analytics.

• JobName: especifica o nome do trabalho U-SQL.

• AnalyticsUnits: especifica a contagem de unidades de análise do trabalho U-SQL.

• Priority: especifica a prioridade do trabalho U-SQL. Defina com um valor de 0 a 1000. Quanto menor o número, maior a prioridade.

• RuntimeVersion: especifica a versão de tempo de execução do Data Lake Analytics do trabalho U-SQL. Ele é definido como "padrão" por padrão. Normalmente, você não precisa alterar essa propriedade.

• Synchronous: um valor booliano que especifica se a tarefa deve aguardar a conclusão do trabalho ou não. Se o valor for definido como true, a tarefa será marcada como sucesso após a conclusão do trabalho. Se o valor for definido como false, a tarefa será marcada como sucesso após o trabalho passar pela fase de preparação.

  Valor	Descrição
  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.
  Falso	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: especifica um tempo limite em segundos para a execução do trabalho. Se o trabalho atingir o tempo limite, será cancelado e marcado como com falha. A propriedade não estará disponível se Synchronous for definido como falso.

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

Use a página Mapeamento de Parâmetros da caixa de diálogo Editor de Tarefa do Azure Data Lake Analytics para mapear variáveis para parâmetros (variáveis de U-SQL) no script U-SQL.

• Nome da Variável: Depois de adicionar um mapeamento de parâmetros selecionando Adicionar, selecione um sistema ou variável definida pelo usuário na lista. Como alternativa, você pode selecionar <Nova variável...> para adicionar uma nova variável usando a caixa de diálogo Adicionar Variável. Para saber mais, confira Variáveis do SSIS (Integration Services).

• Nome do Parâmetro: forneça um nome de parâmetro/variável no script U-SQL. 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);

No exemplo de script acima, os caminhos de entrada e saída são definidos em parâmetros @in e @out. Os valores para os parâmetros @in e @out no script U-SQL são passados dinamicamente pela configuração de mapeamento de parâmetros.

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.

Confira também

• Gerenciador de Conexão do Azure Data Lake Analytics
• Tarefa do sistema de arquivos do Azure Data Lake Store
• Gerenciador de conexões do Azure Data Lake Store