Execute Process Task

  • Articolo

Si applica a:SQL Server SSIS Integration Runtime in Azure Data Factory

L'attività Esegui processo consente di eseguire un'applicazione o un file batch come parte del flusso di lavoro di un pacchetto di SQL Server Integration Services. Sebbene sia possibile utilizzare l'attività Esegui processo per aprire qualsiasi applicazione standard, ad esempio Microsoft Excel o Microsoft Word, in genere la si utilizza per eseguire applicazioni aziendali o file batch che funzionano con un'origine dati. È ad esempio possibile utilizzare l'attività Esegui processo per espandere un file di testo compresso. Il pacchetto può quindi utilizzare il file di testo come origine dei dati per il proprio flusso di dati. Sempre a titolo di esempio, è possibile utilizzare l'attività Esegui processo per eseguire un'applicazione Visual Basic personalizzata che genera un report giornaliero sulle vendite. che può essere allegato a un'attività Invia messaggi e inoltrato a una lista di distribuzione.

Integration Services include altre attività che consentono l'esecuzione di operazioni di flusso di lavoro, quale l'esecuzione di pacchetti. Per altre informazioni, vedere Attività Esegui pacchetto.

Voci di log personalizzate disponibili nell'attività Esegui processo

Nella tabella seguente sono elencate le voci di log personalizzate disponibili per l'attività Esegui processo. Per altre informazioni, vedere Registrazione di Integration Services (SSIS).

Voce di log Descrizione
ExecuteProcessExecutingProcess Fornisce informazioni sui processi che l'attività dovrà eseguire.

Vengono scritte due voci di log. Una contiene informazioni sul nome e sulla posizione del file eseguibile eseguito dall'attività, l'altra registra l'uscita dal file eseguibile.
ExecuteProcessVariableRouting Fornisce informazioni sulle variabili indirizzate all'input e agli output del file eseguibile. Vengono scritte voci di log per stdin (l'input), stdout (l'output) e stderr (l'output degli errori).

Configurazione dell'attività Esegui processo

È possibile impostare le proprietà tramite Progettazione SSIS o a livello di codice.

Per ulteriori informazioni su come impostare queste proprietà in Progettazione SSIS, vedere Aggiungere o eliminare un'attività o un contenitore in un flusso di controllo.

Impostazioni delle proprietà

Quando l'attività Esegui processo esegue un'applicazione personalizzata, fornisce dati di input all'applicazione tramite uno o entrambi i metodi seguenti:

  • Una variabile specificata nell'impostazione della proprietà StandardInputVariable . Per altre informazioni sulle variabili, vedere Variabili di Integration Services (SSIS) e Variabili di Integration Services (SSIS).

  • Un argomento specificato nell'impostazione della proprietà Arguments . Se, ad esempio, l'attività apre un documento in Word, l'argomento può assegnare un nome al file con estensione doc.

Per passare più argomenti a un'applicazione personalizzata in un'attività Esegui processo, utilizzare gli spazi per delimitarli. Un argomento non può includere uno spazio. In caso contrario, l'attività non verrà eseguita. È possibile utilizzare un'espressione per passare il valore di una variabile come argomento. Nell'esempio seguente l'espressione passa due valori di variabili come argomenti e utilizza uno spazio per delimitare gli argomenti:

@variable1 + " " + @variable2

È possibile utilizzare un'espressione per impostare varie proprietà dell'attività Esegui processo.

Quando si usa la proprietà StandardInputVariable per configurare l'attività Esegui processo in modo che fornisca dati di input, chiamare il metodo Console.ReadLine dall'applicazione per leggere l'input. Per altre informazioni, vedere Metodo Console.ReadLine..

Quando si usa la proprietà Arguments per configurare l'attività Esegui processo in modo che fornisca dati di input, effettuare uno dei passaggi seguenti per ottenere gli argomenti:

  • Se si usa Microsoft Visual Basic per scrivere l'applicazione, impostare la proprietà My.Application.CommandLineArgs . Nell'esempio seguente viene impostata la proprietà My.Application.CommandLineArgs per recuperare due argomenti:

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

    Per altre informazioni, vedere Proprietà ConsoleApplicationBase.CommandLineArgs..

  • Se si usa Microsoft Visual C# per scrivere l'applicazione, usare il metodo Main .

    Per altre informazioni, vedere Argomenti della riga di comando (Guida per programmatori C#).

L'attività Esegui processo include inoltre le proprietà StandardOutputVariable e StandardErrorVariable che consentono di specificare le variabili che usano rispettivamente l'output standard e l'output degli errori dell'applicazione.

È inoltre possibile configurare l'attività Esegui processo specificando una directory di lavoro, un periodo di timeout o un valore che indica se l'esecuzione del file eseguibile è stata completata. L'attività può essere configurata anche in modo da non riuscire se il codice restituito dal file eseguibile non corrisponde al valore che indica il completamento dell'esecuzione oppure se il file eseguibile non viene trovato nel percorso specificato.

Configurazione a livello di codice dell'attività Esegui processo

Per altre informazioni sull'impostazione di queste proprietà a livello di programmazione, vedere ExecuteProcess.

Editor attività Esegui processo (pagina Generale)

Usare la pagina Generale della finestra di dialogo Editor attività Esegui processo per assegnare un nome e una descrizione all'attività Esegui processo.

Opzioni

Nome
Consente di specificare un nome univoco per l'attività Esegui processo. Tale nome viene utilizzato come etichetta nell'icona dell'attività.

Nota

I nomi delle attività devono essere univoci all'interno di un pacchetto.

Descrizione
Consente di digitare una descrizione dell'attività Esegui processo.

Editor attività Esegui processo (pagina Processo)

Utilizzare la pagina Processo della finestra di dialogo Editor attività Esegui processo per configurare le opzioni di esecuzione del processo. Tali opzioni includono il file eseguibile da avviare, il relativo percorso, gli argomenti del prompt dei comandi, nonché le variabili per la generazione dell'input e l'acquisizione dell'output.

Opzioni

RequireFullFileName
Consente di indicare se l'attività deve avere esito negativo nel caso in cui il file eseguibile non venga trovato nel percorso specificato.

File eseguibile
Consente di digitare il nome del file eseguibile da avviare.

Argomenti
Consente di specificare gli argomenti del prompt dei comandi.

WorkingDirectory
Digitare il percorso della cartella contenente il file eseguibile oppure selezionare il pulsante sfoglia (...) per individuare la cartella.

StandardInputVariable
Selezionare una variabile per l'invio dell'input al processo oppure selezionare <Nuova variabile...> per crearne una nuova:

Argomenti correlati:Variabili di Integration Services (SSIS)

StandardOutputVariable
Selezionare una variabile per l'acquisizione dell'output del processo oppure selezionare <Nuova variabile...> per crearne una nuova.

StandardErrorVariable
Selezionare una variabile per l'acquisizione dell'output di errore del processore oppure selezionare <Nuova variabile...> per crearne una nuova.

FailTaskIfReturnCodeIsNotSuccessValue
Consente di indicare se l'attività deve avere esito negativo nel caso in cui il codice di uscita del processo non corrisponda al valore specificato in SuccessValue.

SuccessValue
Consente di specificare il valore restituito dal file eseguibile per segnalare l'esito positivo. Per impostazione predefinita, questo valore è impostato su 0.

TimeOut
Consente di specificare il numero di secondi di esecuzione del processo. Il valore 0 indica che non è previsto alcun timeout e il processo viene eseguito fino al completamento o finché non si verifica un errore.

TerminateProcessAfterTimeOut
Consente di indicare se il processo deve essere terminato allo scadere del periodo di timeout specificato nell'opzione TimeOut . Questa opzione è disponibile solo se TimeOut non è 0.

WindowStyle
Consente di specificare lo stile della finestra in cui viene eseguito il processo.

Contenuto correlato