Partilhar via

Tarefa de Executar Processo

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

A tarefa Executar Processo executa uma aplicação ou ficheiro batch como parte de um fluxo de trabalho do pacote SQL Server Integration Services. Embora possa usar a tarefa Executar Processo para abrir qualquer aplicação padrão, como Microsoft Excel ou Microsoft Word, normalmente utiliza-a para executar aplicações empresariais ou ficheiros em lote que funcionam contra uma fonte de dados. Por exemplo, pode usar a tarefa Executar Processo para expandir um ficheiro de texto comprimido. Depois, o pacote pode usar o ficheiro de texto como fonte de dados para o fluxo de dados dentro do pacote. Como outro exemplo, pode usar a tarefa Executar Processo para executar uma aplicação Visual Basic personalizada que gera um relatório diário de vendas. Depois podes anexar o relatório a uma tarefa de Enviar Correio e encaminhar o relatório para uma lista de distribuição.

Os Serviços de Integração incluem outras tarefas que realizam operações de fluxo de trabalho, como a execução de pacotes. Para obter mais informações, consulte Executar tarefa de pacote.

Entradas de registo personalizadas disponíveis na tarefa Executar Processo

A tabela seguinte lista as entradas de registo personalizadas para a tarefa Executar Processo. Para obter mais informações, consulte o Log de Serviços de Integração (SSIS) .

Entrada de log Descrição
ExecutarProcessoExecutandoProcesso Fornece informação sobre o processo para o qual a tarefa está configurada para executar.

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

Configuração da tarefa de Executar Processo

Você pode definir propriedades por meio do SSIS Designer ou programaticamente.

Para mais informações sobre como definir estas propriedades no SSIS Designer, veja Adicionar ou Eliminar uma Tarefa ou um Contentor num Fluxo de Controlo.

Configurações de propriedade

Quando a tarefa Executar Processo executa uma aplicação personalizada, a tarefa fornece entrada para a aplicação através de um ou de ambos os seguintes métodos:

Para passar múltiplos argumentos a uma aplicação personalizada numa tarefa de Executar Processo, use espaços para delimitar os argumentos. Um argumento não pode incluir um espaço; caso contrário, a tarefa não é executada. Podes usar uma expressão para passar um valor variável como argumento. No exemplo seguinte, a expressão passa dois valores de variáveis como argumentos e usa um espaço para delimitar os argumentos:

@variable1 + " " + @variable2

Pode usar uma expressão para definir várias propriedades de uma tarefa de Execução de Processo.

Quando usar a propriedade StandardInputVariable para configurar a tarefa Executar Processo para fornecer entrada, chame o método Console.ReadLine da aplicação para ler a entrada. Para mais informações, consulte Método Console.ReadLine.

Quando usar a propriedade Argumentos para configurar a tarefa Executar Processo para fornecer entrada, faça um dos seguintes passos para obter os argumentos:

  • Se usar o Microsoft Visual Basic para escrever a aplicação, defina a propriedade My.Application.CommandLineArgs . O exemplo seguinte 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 mais informações, consulte ConsoleApplicationBase.CommandLineArgs Property.

  • Se usar Microsoft Visual C# para escrever a aplicação, use o método Main .

    Para mais informações, consulte Command-Line Argumentos (Guia de Programação em C#).

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

Além disso, pode configurar a tarefa Executar Processo para especificar um diretório funcional, um período de time-out ou um valor que indique que o executável correu com sucesso. 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 sucesso, ou se o executável não for encontrado na localização especificada.

Configuração programática da tarefa Executar Processo

Para mais informações sobre como definir programaticamente estas propriedades, veja ExecuteProcess.

Editor de Tarefas de Execução de Processos (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 único para a tarefa Executar Processo. Esse nome é usado como o rótulo no ícone da tarefa.

Observação

Os nomes das tarefas devem ser exclusivos dentro de um pacote.

Descrição
Escreva uma descrição da tarefa Executar Processo.

Executar Editor de Tarefas do Processo (página do Processo)

Use a página Processo da caixa de diálogo Executar Editor de Tarefas do Processo para configurar as opções que executam o processo. Estas opções incluem o executável a executar, a sua localização, argumentos do prompt de comandos e as variáveis que fornecem entrada e captura de saída.

Opções

RequireFullFileName
Indique se a tarefa deve falhar caso o executável não seja encontrado na localização especificada.

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

Argumentos
Forneça argumentos na linha de comandos.

Diretório de trabalho
Digite o caminho da pasta que contém o executável, ou selecione o botão de navegar (...) e localize a pasta.

VariávelDeEntradaPadrão
Selecione uma variável para fornecer a entrada ao processo, ou selecione <Nova variável...> para criar uma nova variável:

Tópicos Relacionados:Variáveis dos Serviços de Integração (SSIS)

VariávelSaídaPadrão
Seleciona uma variável para captar a saída do processo, ou seleciona <Nova variável...> para criar uma nova variável.

StandardErrorVariable
Selecionar uma variável para capturar o erro do processador, ou selecionar <Nova variável...> para criar uma nova variável.

FalharTarefaSeCódigoDeRetornoNãoForValorDeSucesso
Indique se a tarefa falha se o código de saída do processo for diferente do valor especificado em SucessoValor.

ValorDeSucesso
Especifique o valor devolvido pelo executável para indicar sucesso. Por defeito, este valor é definido para 0.

TimeOut
Especifique o número de segundos que o processo pode executar. Um valor de 0 indica que não é utilizado nenhum valor de time-out, e o processo corre até ser concluído ou até ocorrer um erro.

EncerrarProcessoApósTempoLimite
Indique se o processo é forçado a terminar após o período de tempo especificado pela opção TimeOut . Esta opção está disponível apenas se TimeOut não estiver 0.

WindowStyle
Especifique o estilo da janela em que o processo deve ser executado.

Conteúdo relacionado

  • Last updated on