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.