Partilhar via


Tarefa Executar Processo

Aplica-se a: SQL Server SSIS Integration Runtime no Azure Data Factory

A tarefa Executar Processo executa um aplicativo ou arquivo de lote como parte de um fluxo de trabalho do pacote do SQL Server Integration Services. Embora você possa usar a tarefa Executar Processo para abrir qualquer aplicativo padrão, como Microsoft Excel ou Microsoft Word, você geralmente o utiliza para executar aplicativos de negócios ou arquivos de lote que trabalham contra uma fonte de dados. Por exemplo, você pode usar a tarefa Executar Processo para expandir um arquivo de texto compactado. Depois, o pacote pode usar o arquivo de texto como uma fonte de dados para o fluxo de dados no pacote. Como outro exemplo, você pode usar a tarefa Executar Processo para executar um aplicativo Visual Basic personalizado que gera um relatório de vendas diário. Em seguida, você pode anexar o relatório a uma tarefa Enviar Email e encaminhar o relatório para uma lista de distribuição.

O Integration Services inclui outras tarefas que realizam operações de fluxo de trabalho como executar pacotes. Para obter mais informações, consulte Execute Package Task.

Entradas de log personalizadas disponíveis na tarefa Executar Processo

A tabela a seguir relaciona as entradas de log personalizadas para a tarefa Executar Processo. Para obter mais informações, consulte Log do SSIS (Integration Services).

Entrada de log Descrição
ExecuteProcessExecutingProcess Fornece informações sobre o processo que a tarefa é configurada para executar.

São gravadas duas entradas de log. Uma contém informações sobre o nome e o local do executável que a tarefa executa e a outra registra a saída do executável.
ExecuteProcessVariableRouting Fornece informações sobre quais variáveis são encaminhadas para a entrada e as saídas do executável. As entradas de log são gravadas em stdin (a entrada), stdout (a saída) e stderr (a saída do erro).

Configuração da tarefa Executar Processo

Você pode definir propriedades pelo Designer do SSIS ou programaticamente.

Para obter mais informações sobre como definir essas propriedades no Designer SSIS, consulte Adicionar ou excluir uma tarefa ou um contêiner em um fluxo de controle.

Configurações de propriedades

Quando a tarefa Executar Processo executa um aplicativo personalizado, a tarefa fornece entrada para o aplicativo por meio de um ou de ambos estes métodos:

  • Uma variável que você especifica na configuração da propriedade StandardInputVariable . Para obter mais informações sobre variáveis, consulte Variáveis do Integration Services (SSIS) e Variáveis do Integration Services (SSIS).

  • Um argumento que você especifica na configuração de propriedade Arguments . Por exemplo, se a tarefa abrir um documento no Word, o argumento poderá nomear o arquivo .doc.

Para passar vários argumentos a um aplicativo personalizado em uma tarefa Executar Processo, use espaços para delimitar os argumentos. Um argumento não pode incluir espaço, ou a tarefa não será executada. Você pode usar uma expressão para passar um valor variável como argumento. No exemplo a seguir, a expressão passa dois valores variáveis como argumentos e usa um espaço para delimitar os argumentos:

@variable1 + " " + @variable2

Você pode usar uma expressão para definir várias propriedades da tarefa Executar Processo.

Quando você usar a propriedade StandardInputVariable para configurar a tarefa Executar Processo para fornecer entrada, chame o método Console.ReadLine do aplicativo para ler a entrada. Para obter mais informações, confira Método Console.ReadLine.

Quando você usar a propriedade Arguments para configurar a tarefa Executar Processo para fornecer entrada, execute uma destas etapas para obter os argumentos:

  • Se você usar Microsoft Visual Basic para escrever o aplicativo, defina a propriedade My.Application.CommandLineArgs . O exemplo a seguir define a propriedade My.Application.CommandLineArgs para recuperar dois argumentos:

    Dim variable1 As String = My.Application.CommandLineArgs.Item(0)
    Dim variable2 As String = My.Application.CommandLineArgs.Item(1)
    

    Para obter mais informações, consulte a propriedade ConsoleApplicationBase.CommandLineArgs.

  • Se você usar o Microsoft Visual C# para escrever o aplicativo, use o método Main.

    Para obter mais informações, consulte o tópico Argumentos da linha de comando (Guia de programação em C#).

A tarefa Executar Processo também inclui as propriedades StandardOutputVariable e StandardErrorVariable para especificar as variáveis que consomem a saída padrão e a saída de erro do aplicativo, respectivamente.

Além disso, você pode configurar a tarefa Executar Processo para especificar um diretório de trabalho, um tempo-limite ou um valor para indicar que o executável foi executado com êxito. A tarefa também pode ser configurada para falhar se o código de retorno do executável não corresponder ao valor que indica êxito, ou se o executável não for encontrado no local especificado.

Configuração programática da tarefa Executar Processo

Para obter mais informações sobre como definir essas propriedades de forma programática, consulte ExecuteProcess.

Editor da tarefa Executar Processo (página Geral)

Use a página Geral da caixa de diálogo Editor de tarefa Executar Processo para nomear e descrever a tarefa Executar Processo.

Opções

Nome
Forneça um nome exclusivo para a tarefa Executar Processo. Esse nome é usado como rótulo no ícone de tarefa.

Observação

Os nomes das tarefas devem ser exclusivos em um pacote.

Descrição
Digite uma descrição para a tarefa Executar Processo.

Executar o editor de tarefa Processar (página Processar)

Use a página Processo da caixa de diálogo Editor da Tarefa Executar Processo , para configurar as opções que executam o processo. As opções incluem o executável a ser utilizado, seu local, argumentos do prompt de comando e as variáveis que fornecem entrada e capturam a saída.

Opções

RequireFullFileName
Indique se a tarefa deve falhar se o executável não for encontrado no local especificado.

Executável
Digite o nome do executável a utilizar.

Argumentos
Forneça argumentos do prompt de comando.

WorkingDirectory
Digite o caminho da pasta que contém o executável ou selecione o botão Procurar (…) e localize a pasta.

StandardInputVariable
Selecione a variável para fornecer a entrada para o processo ou clique em <Nova variável...> para criar uma variável:

Tópicos relacionados: Variáveis do Integration Services (SSIS)

StandardOutputVariable
Selecione uma variável para capturar a saída do processo ou clique em <Nova variável...> para criar uma variável.

StandardErrorVariable
Selecione uma variável para capturar a saída de erros do processador ou clique em <Nova variável...> para criar uma variável.

FailTaskIfReturnCodeIsNotSuccessValue
Indique se a tarefa deve falhar caso o código de saída do processo seja diferente do valor especificado em SuccessValue.

SuccessValue
Especifique o valor retornado pelo executável para indicar êxito. Por padrão, esse valor está definido como 0.

TimeOut
Especifique o número de segundos em que o processo pode ser executado. Um valor 0 indica que não é usado nenhum valor de tempo limite e o processo é executado até ser concluído ou até um erro ocorrer.

TerminateProcessAfterTimeOut
Indique se o processo é forçado a terminar após o tempo limite especificado pela opção TimeOut . Esta opção só estará disponível se TimeOut não for 0.

WindowStyle
Especifique o estilo de janela no qual executar o processo.