catalog.create_execution (database SSISDB)catalog.create_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

Crea un'istanza di esecuzione nel catalogo di Integration ServicesIntegration Services.Creates an instance of execution in the Integration ServicesIntegration Services catalog.

Questa stored procedure utilizza il livello di registrazione server predefinito.This stored procedure uses the default server logging level.

SintassiSyntax

catalog.create_execution [@folder_name = folder_name  
     , [@project_name =] project_name  
     , [@package_name =] package_name  
  [  , [@reference_id =] reference_id ]  
  [  , [@use32bitruntime =] use32bitruntime ] 
  [  , [@runinscaleout =] runinscaleout ]
  [  , [@useanyworker =] useanyworker ] 
     , [@execution_id =] execution_id OUTPUT  

ArgomentiArguments

[@folder_name =] folder_name[@folder_name =] folder_name
Nome della cartella contenente il pacchetto che deve essere eseguito.The name of the folder that contains the package that is to be executed. folder_name è di tipo nvarchar(128).The folder_name is nvarchar(128).

[@project_name =] project_name[@project_name =] project_name
Nome del progetto contenente il pacchetto che deve essere eseguito.The name of the project that contains the package that is to be executed. project_name è di tipo nvarchar(128).The project_name is nvarchar(128).

[@package_name =] package_name[@package_name =] package_name
Nome del pacchetto che deve essere eseguito.The name of the package that is to be executed. package_name è di tipo nvarchar(260).The package_name is nvarchar(260).

[@reference_id =] reference_id[@reference_id =] reference_id
Identificatore univoco per un riferimento all'ambiente.A unique identifier for an environment reference. Questo parametro è facoltativo.This parameter is optional. reference_id è di tipo bigint.The reference_id is bigint.

[@use32bitruntime =] use32bitruntime[@use32bitruntime =] use32bitruntime
Viene indicato se il runtime a 32 bit deve essere utilizzato per eseguire il pacchetto in un sistema operativo a 64 bit.Indicates if the 32-bit runtime should be used to run the package on a 64-bit operating system. Usare il valore 1 per eseguire il pacchetto con il runtime a 32 bit quando in esecuzione in un sistema operativo a 64 bit.Use the value of 1 to execute the package with the 32-bit runtime when running on a 64-bit operating system. 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.Use the value of 0 to execute the package with the 64-bit runtime when running on a 64-bit operating system. Questo parametro è facoltativo.This parameter is optional. use32bitruntime è di tipo bit.The Use32bitruntime is bit.

[@runinscaleout =] runinscaleout[@runinscaleout =] runinscaleout
Indica se l'esecuzione è in Scale Out. Usare il valore 1 per eseguire il pacchetto in Scale Out. Usare il valore 0 per eseguire il pacchetto senza Scale Out. Questo parametro è facoltativo.Indicate whether the execution is in Scale Out. Use the value of 1 to execute the package in Scale Out. Use the value of 0 to execute the package without Scale Out. This parameter is optional. Se non specificato, il valore di questo è impostato su DEFAULT_EXECUTION_MODE in [SSISDB].[catalog].[catalog_properties].If not specified, its value is set to DEFAULT_EXECUTION_MODE in [SSISDB].[catalog].[catalog_properties]. runinscaleout è di tipo bit.The runinscaleout is bit.

[@useanyworker =] useanyworker[@useanyworker =] useanyworker
Indica se a un qualsiasi ruolo di lavoro Scale Out è consentita l'esecuzione.Indicate whether any Scale Out Worker is allowed to do the execution.

  • Usare il valore 1 per eseguire il pacchetto con un ruolo di lavoro Scale Out.Use the value of 1 to execute the package with any Scale Out Worker. Quando si imposta @useanyworker su true, qualsiasi ruolo di lavoro il cui numero massimo di attività (specificato nel file di configurazione di del ruolo di lavoro) non è stato ancora raggiunto è disponibile per l'esecuzione del pacchetto.When you set @useanyworker to true, any worker whose maximum task count (as specified in the worker configuration file) is not yet reached is available to run the package. Per informazioni sul file di configurazione del ruolo di lavoro, vedere Ruolo di lavoro di scalabilità orizzontale di Integration Services (SSIS).For info about the worker configuration file, see Integration Services (SSIS) Scale Out Worker.

  • Usare il valore 0 per indicare che non tutti i ruoli di lavoro Scale Out sono autorizzati a eseguire il pacchetto.Use the value of 0 to indicate that not all Scale Out Workers are allowed to execute the package. Quando si imposta @useanyworker su false è necessario specificare i ruoli di lavoro autorizzati a eseguire il pacchetto mediante Scale Out Manager oppure chiamando l'istruzione [catalog].[add_execution_worker] della stored procedure.When you set @useanyworker to false, you have to specify the workers that are allowed to run the package by using Scale Out Manager or by calling the stored procedure [catalog].[add_execution_worker]. Se si specifica un ruolo di lavoro che esegue già un altro pacchetto, il ruolo di lavoro completa l'esecuzione del pacchetto corrente prima di richiedere un'altra esecuzione.If you specify a worker that's already running another package, the worker finishes running the current package before it requests another execution.

Questo parametro è facoltativo.This parameter is optional. Se non specificato, il valore viene impostato su 1.If not specified, its value is set to 1. useanyworker è di tipo bit.The useanyworker is bit.

[@execution_id =] execution_id[@execution_id =] execution_id
Viene restituito l'identificatore univoco per un'istanza di esecuzione.Returns the unique identifier for an instance of execution. execution_id è di tipo bigint.The execution_id is bigint.

RemarksRemarks

Un'esecuzione viene utilizzata per specificare i valori del parametro utilizzati da un pacchetto durante una singola istanza di esecuzione del pacchetto.An execution is used to specify the parameter values that are a package uses during a single instance of package execution.

Se viene specificato un riferimento all'ambiente 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.If an environment reference is specified with the reference_id parameter, the stored procedure populates the project and package parameters with literal values or referenced values from the corresponding environment variables. Se viene specificato il riferimento all'ambiente, durante l'esecuzione del pacchetto vengono utilizzati i valori di parametro predefiniti.If environment reference is specified, default parameter values are used during package execution. Per determinare esattamente quali valori vengono usati per un'istanza di esecuzione specifica, usare il valore del parametro di output execution_id di questa stored procedure ed eseguire una query sulla vista execution_parameter_values.To determine exactly which values are used for a particular instance of execution, use the execution_id output parameter value from this stored procedure and query the execution_parameter_values view.

In un'esecuzione possono essere specificati solo i pacchetti contrassegnati come pacchetti del punto di ingresso.Only packages that are marked as entry point packages can be specified in an execution. In caso contrario, l'esecuzione non viene completata.If a package that is not an entry point is specified, the execution fails.

EsempioExample

Nell'esempio seguente viene effettuata una chiamata a catalog.create_execution per creare un'istanza di esecuzione del pacchetto Child1.dtsx, non in Scale Out. Il pacchetto è incluso in Project1 di Integration Services.The following example calls catalog.create_execution to create an instance of execution for the Child1.dtsx package, which is not in Scale Out. 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

NoneNone

AutorizzazioniPermissions

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

  • Autorizzazioni READ e EXECUTE sul progetto e, se applicabile, autorizzazioni READ sull'ambiente a cui si fa riferimentoREAD and EXECUTE permissions on the project and, if applicable, READ permissions on the referenced environment

  • Appartenenza al ruolo del database ssis_adminMembership to the ssis_admin database role

  • Appartenenza al ruolo del server sysadminMembership to the sysadmin server role

    Se @runinscaleout è uguale a 1, per questa stored procedure è necessaria una delle autorizzazioni seguenti:If @runinscaleout is 1, the stored procedure requires one of the following permissions:

  • Appartenenza al ruolo del database ssis_adminMembership to the ssis_admin database role

  • Appartenenza al ruolo del database ssis_cluster_executorMembership to the ssis_cluster_executor database role

  • Appartenenza al ruolo del server sysadminMembership 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 can raise an error or warning:

  • Il pacchetto non esiste.The package does not exist.

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

  • L'ambiente di riferimento, reference_id, non è valido.The environment reference, reference_id, is not valid.

  • Specificato pacchetto che non è un pacchetto del punto di ingresso.The package that is specified is not an entry point package.

  • Tipo di dati della variabile di ambiente a cui si fa riferimento diverso dal tipo di dati del parametro di progetto o di pacchetto.The data type of the referenced environment variable is different from the data type of the project or package parameter.

  • Progetto o pacchetto in cui sono contenuti parametri che richiedono valori, ma non è stato assegnato alcun valore.The project or package contains parameters that require values, but no values have been assigned.

  • Non è possibile trovare le variabili di ambiente a cui si fa riferimento nell'ambiente specificato dal riferimento all'ambiente, reference_id.The referenced environment variables cannot be found in the environment that the environment reference, reference_id, specifies.

Vedere ancheSee Also

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