catalog.start_execution (database SSISDB)catalog.start_execution (SSISDB Database)

QUESTO ARGOMENTO SI APPLICA A: sìSQL Server (a partire dalla versione 2012)noAzure SQL DatabasenoAzure SQL Data Warehouse noParallel Data Warehouse THIS TOPIC APPLIES TO: yesSQL Server (starting with 2012)noAzure SQL DatabasenoAzure SQL Data Warehouse noParallel Data Warehouse

Viene avviata un'istanza di esecuzione nel catalogo di Integration ServicesIntegration Services.Starts an instance of execution in the Integration ServicesIntegration Services catalog.

SintassiSyntax

catalog.start_execution [@execution_id =] execution_id [, [@retry_count =] retry_count]  

ArgomentiArguments

[@execution_id =] valore di execution_id[@execution_id =] execution_id
Identificatore univoco per l'istanza di esecuzione.The unique identifier for the instance of execution. Il valore di execution_id è bigint.The execution_id is bigint.

[@retry_count =] conteggio_tentativi[@retry_count =] retry_count
Il numero di tentativi se l'esecuzione ha esito negativo.The retry count if the execution fails. Ha effetto solo se l'esecuzione è in orizzontale. Questo parametro è facoltativo.It takes effect only if the execution is in Scale Out. This parameter is optional. Se non specificato, il valore è impostato su 0.If not specified, its value is set to 0. Il conteggio_tentativi è int.The retry_count is int.

OsservazioniRemarks

Un'esecuzione viene utilizzata per specificare i valori di parametro che viene utilizzato da un pacchetto durante una singola istanza di esecuzione del pacchetto.An execution is used to specify the parameter values that is used by a package during a single instance of package execution. Dopo che è stata creata un'istanza di esecuzione, prima che venga avviata, il progetto corrispondente potrebbe essere ridistribuito.After an instance of execution has been created, before it has been started, the corresponding project might be redeployed. In questo caso, l'istanza di esecuzione fa riferimento a un progetto che non è aggiornato.In this case, the instance of execution references a project that is outdated. Questo riferimento non valido fa sì che la stored procedure per l'esito negativo.This invalid reference causes the stored procedure to fail.

Nota

Le esecuzioni possono essere avviate solo una volta.Executions can only be started once. Per avviare un'istanza di esecuzione, deve essere nello stato di creazione (valore 1 nel stato colonna del Catalog. Operations Vista).To start an instance of execution, it must be in the created state (a value of 1 in the status column of the catalog.operations view).

EsempioExample

Nell'esempio seguente viene chiamato catalog.create_execution per creare un'istanza di esecuzione del pacchetto Child1.dtsx.The following example calls catalog.create_execution to create an instance of execution for the Child1.dtsx package. Il pacchetto è incluso in Project1 di Integration Services.Integration Services Project1 contains the package. Nell'esempio viene chiamato catalog.set_execution_parameter_value per impostare i valori per i parametri Parameter1, Parameter2 e LOGGING_LEVEL.The example calls catalog.set_execution_parameter_value to set values for the Parameter1, Parameter2, and LOGGING_LEVEL parameters. Inoltre viene chiamato catalog.start_execution per avviare un'istanza di esecuzione.The example calls catalog.start_execution to start an instance of execution.

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 del codice restituitoReturn Code Value

0 (esito positivo)0 (success)

Set di risultatiResult Sets

NessunoNone

PermissionsPermissions

Per questa stored procedure è necessaria una delle autorizzazioni seguenti:This stored procedure requires one of the following permissions:

  • 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 riferimentoREAD and MODIFY permissions on the instance of execution, READ and EXECUTE permissions on the project, and if applicable, READ permissions on the referenced environment

  • L'appartenenza al ssis_admin ruolo del databaseMembership to the ssis_admin database role

  • L'appartenenza al sysadmin ruolo del serverMembership to the sysadmin server role

Errori e avvisiErrors and Warnings

Nell'elenco seguente vengono descritte alcune condizioni che possono generare un errore o un avviso:The following list describes some conditions that may raise an error or warning:

  • Utente senza autorizzazioni appropriate.The user does not have the appropriate permissions

  • Identificatore di esecuzione non validoThe execution identifier is not valid

  • Esecuzione già avviata o già completata. Le esecuzioni possono essere avviate solo una voltaThe execution has already been started, or it has already been completed; executions can be started only once

  • Riferimento all'ambiente associato al progetto non validoThe environment reference associated with the project is not valid

  • Valori del parametro obbligatori non impostatiRequired parameter values have not been set

  • Versione del progetto associata all'istanza di esecuzione obsoleta. Può essere eseguita solo la versione più corrente di un progetto.The project version associated with the instance of execution is outdated; only the most current version of a project can be executed