catalog.start_execution (database SSISDB)

Articolo
05/07/2013

Viene avviata un'istanza di esecuzione nel catalogo di Integration Services.

Sintassi

start_execution [ @execution_id = ] execution_id

Argomenti

[ @execution\_id = ] execution_id
Identificatore univoco per l'istanza di esecuzione. execution_id è di tipo bigint.

Osservazioni

Un'esecuzione viene utilizzata per specificare i valori del parametro che saranno utilizzati da un pacchetto durante una singola istanza di esecuzione del pacchetto. Dopo che è stata creata un'istanza di esecuzione, prima che venga avviata, il progetto corrispondente potrebbe essere ridistribuito. In questo caso, l'istanza di esecuzione farà riferimento a un progetto obsoleto e ciò causerà il mancato completamento della stored procedure.

[!NOTA]

Le esecuzioni possono essere avviate solo una volta. Per avviare un'istanza di esecuzione, questa deve essere nello stato di creazione (valore di 1 nella colonna status della vista catalog.operations).

Esempio

Nell'esempio seguente viene chiamato catalog.create_execution per creare un'istanza di esecuzione del pacchetto Child1.dtsx. Il pacchetto è incluso in Project1 di Integration Services. Nell'esempio viene chiamato catalog.set_execution_parameter_value per impostare i valori per i parametri Parameter1, Parameter2 e LOGGING_LEVEL. Inoltre viene chiamato catalog.start_execution per avviare un'istanza di esecuzione.

Declare @execution_id bigint
EXEC [SSISDB].[catalog].[create_execution] @package_name=N'Child1.dtsx', @execution_id=@execution_id OUTPUT, @folder_name=N'TestDeply4', @project_name=N'Integration Services Project1', @use32bitruntime=False, @reference_id=Null
Select @execution_id
DECLARE @var0 sql_variant = N'Child1.dtsx'
EXEC [SSISDB].[catalog].[set_execution_parameter_value] @execution_id, @object_type=20, @parameter_name=N'Parameter1', @parameter_value=@var0
DECLARE @var1 sql_variant = N'Child2.dtsx'
EXEC [SSISDB].[catalog].[set_execution_parameter_value] @execution_id, @object_type=20, @parameter_name=N'Parameter2', @parameter_value=@var1
DECLARE @var2 smallint = 1
EXEC [SSISDB].[catalog].[set_execution_parameter_value] @execution_id, @object_type=50, @parameter_name=N'LOGGING_LEVEL', @parameter_value=@var2
EXEC [SSISDB].[catalog].[start_execution] @execution_id
GO

Valore codice restituito

0 (esito positivo)

Set di risultati

Nessuno

Autorizzazioni

Per questa stored procedure è necessaria una delle autorizzazioni seguenti:

Autorizzazioni READ e MODIFY sull'istanza di esecuzione, autorizzazioni READ e EXECUTE sul progetto e, se applicabile, autorizzazioni per la lettura sull'ambiente a cui si fa riferimento
Appartenenza al ruolo del database ssis_admin
Appartenenza al ruolo server sysadmin

Errori e avvisi

Nell'elenco seguente vengono descritte alcune condizioni che possono generare un errore o un avviso:

Utente senza autorizzazioni appropriate
Identificatore di esecuzione non valido
Esecuzione già avviata o già completata. Le esecuzioni possono essere avviate solo una volta
Riferimento all'ambiente associato al progetto non valido
Valori del parametro obbligatori non impostati
Versione del progetto associata all'istanza di esecuzione obsoleta. Può essere eseguita solo la versione più corrente di un progetto.

Condividi tramite