catalog.create_execution (database SSISDB)

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

Questa stored procedure utilizza il livello di registrazione server predefinito.

Sintassi

create_execution [ @folder_name = folder_name
     , [ @project_name = ] project_name
     , [ @package_name = ] package_name
  [  , [ @reference_id = ] reference_id ]
  [  , [ @use32bitruntime = ] use32bitruntime ]
     , [ @execution_id = ] execution_id OUTPUT

Argomenti

  • [ @folder\_name = ] folder_name
    Nome della cartella contenente il pacchetto che deve essere eseguito. folder_name è di tipo nvarchar(128).

  • [ @project\_name = ] project_name
    Nome del progetto contenente il pacchetto che deve essere eseguito. project_name è di tipo nvarchar(128).

  • [ @package\_name = ] package_name
    Nome del pacchetto che deve essere eseguito. package_name è di tipo nvarchar(260).

  • [ @reference\_id = ] reference_id
    Identificatore univoco per un riferimento all'ambiente. Questo parametro è facoltativo. reference_id è di tipo bigint.

  • [ @use32bitruntime = ] use32bitruntime
    Viene indicato se il runtime a 32 bit deve essere utilizzato per eseguire il pacchetto in un sistema operativo a 64 bit. Utilizzare il valore pari a 1 per eseguire il pacchetto con il runtime a 32 bit quando in esecuzione in un sistema operativo a 64 bit. Utilizzare il valore pari a 0 per eseguire il pacchetto con il runtime a 64 bit quando in esecuzione in un sistema operativo a 64 bit. Questo parametro è facoltativo. Use32bitruntime è di tipo bit.

  • [ @execution\_id = ] execution_id
    Viene restituito l'identificatore univoco per un'istanza di esecuzione. execution_id è di tipo bigint.

Osservazioni

Un'esecuzione viene utilizzata per specificare i valori del parametro utilizzati da un pacchetto durante una singola istanza di esecuzione del pacchetto.

Se un riferimento all'ambiente viene specificato con il parametro reference_id, i parametri di progetto e di pacchetto vengono popolati dalla stored procedure con valori letterali o valori di riferimento dalle variabili di ambiente corrispondenti. Se viene specificato il riferimento all'ambiente, durante l'esecuzione del pacchetto vengono utilizzati i valori di parametro predefiniti. Per determinare esattamente quali valori vengono utilizzati per una particolare istanza di esecuzione, utilizzare il valore del parametro di output execution_id di questa stored procedure ed eseguire una query sulla vista execution_parameter_values.

In un'esecuzione possono essere specificati solo i pacchetti contrassegnati come pacchetti del punto di ingresso. In caso contrario, l'esecuzione non viene completata.

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 EXECUTE sul progetto e, se applicabile, autorizzazioni READ 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:

  • Il pacchetto non esiste.

  • Utente senza autorizzazioni appropriate.

  • Riferimento all'ambiente, reference_id, non valido.

  • Specificato pacchetto che non è un pacchetto del punto di ingresso.

  • Tipo di dati della variabile di ambiente a cui si fa riferimento diverso dal tipo di dati del parametro di progetto o di pacchetto.

  • Progetto o pacchetto in cui sono contenuti parametri che richiedono valori, ma non è stato assegnato alcun valore.

  • Impossibile trovare le variabili di ambiente a cui si fa riferimento nell'ambiente specificato dal riferimento all'ambiente, reference_id.

Vedere anche

Riferimento

catalog.start_execution (database SSISDB)

catalog.set_execution_parameter_value (database SSISDB)