catalog.create_execution (base de données SSISDB)catalog.create_execution (SSISDB Database)

CETTE RUBRIQUE S’APPLIQUE À : ouiSQL Server (à partir de la version 2012)nonAzure SQL DatabasenonAzure SQL Data WarehousenonParallel Data Warehouse THIS TOPIC APPLIES TO: yesSQL Server (starting with 2012)noAzure SQL DatabasenoAzure SQL Data Warehouse noParallel Data Warehouse

Crée une instance d'exécution dans le catalogue Integration ServicesIntegration Services.Creates an instance of execution in the Integration ServicesIntegration Services catalog.

Cette procédure stockée utilise le niveau de journalisation par défaut du serveur.This stored procedure uses the default server logging level.

SyntaxeSyntax

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  

ArgumentsArguments

[@folder_name =] folder_name[@folder_name =] folder_name
Nom du dossier qui contient le package qui sera exécuté.The name of the folder that contains the package that is to be executed. folder_name est de type nvarchar(128).The folder_name is nvarchar(128).

[@project_name =] project_name[@project_name =] project_name
Nom du projet qui contient le package à exécuter.The name of the project that contains the package that is to be executed. project_name est de type nvarchar(128).The project_name is nvarchar(128).

[@package_name =] package_name[@package_name =] package_name
Nom du package qui sera exécuté.The name of the package that is to be executed. package_name est de type nvarchar(260).The package_name is nvarchar(260).

[@reference_id =] reference_id[@reference_id =] reference_id
Identificateur unique d'une référence environnementale.A unique identifier for an environment reference. Ce paramètre est facultatif.This parameter is optional. reference_id est de type bigint.The reference_id is bigint.

[@use32bitruntime =] use32bitruntime[@use32bitruntime =] use32bitruntime
Indique si l'exécution 32 bits doit être utilisée pour exécuter le package sur un système d'exploitation 64 bits.Indicates if the 32-bit runtime should be used to run the package on a 64-bit operating system. Utilisez la valeur 1 pour exécuter le package avec l’exécution 32 bits quand un système d’exploitation 64 bits est exécuté.Use the value of 1 to execute the package with the 32-bit runtime when running on a 64-bit operating system. Utilisez la valeur 0 pour exécuter le package avec l'exécution 64 bits lorsqu'un système d'exploitation 64 bits est exécuté.Use the value of 0 to execute the package with the 64-bit runtime when running on a 64-bit operating system. Ce paramètre est facultatif.This parameter is optional. Use32bitruntime est de type bit.The Use32bitruntime is bit.

[@runinscaleout =] runinscaleout[@runinscaleout =] runinscaleout
Indique si l’exécution a lieu dans Scale Out. Utilisez la valeur 1 pour exécuter le package dans Scale Out. Utilisez la valeur 0 pour exécuter le package sans Scale Out. Ce paramètre est facultatif.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. S’il n’est pas spécifié, sa valeur est définie sur DEFAULT_EXECUTION_MODE dans [SSISDB].[catalog].[catalog_properties].If not specified, its value is set to DEFAULT_EXECUTION_MODE in [SSISDB].[catalog].[catalog_properties]. runinscaleout est de type bit.The runinscaleout is bit.

[@useanyworker =] useanyworker[@useanyworker =] useanyworker
Indique si un Scale Out Worker est autorisé à effectuer l’exécution.Indicate whether any Scale Out Worker is allowed to do the execution.

  • Utilisez la valeur 1 pour exécuter le package avec n’importe quel Scale Out Worker.Use the value of 1 to execute the package with any Scale Out Worker. Quand vous définissez @useanyworker sur true, tout Worker dont le nombre maximal de tâches (tel que spécifié dans son fichier de configuration) n’est pas encore atteint est disponible pour exécuter le package.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.

  • Utilisez la valeur 0 pour indiquer que tous les Scale Out Workers ne sont pas autorisés à exécuter le package.Use the value of 0 to indicate that not all Scale Out Workers are allowed to execute the package. Quand vous définissez @useanyworker sur false, vous devez spécifier les Workers qui sont autorisés à exécuter le package à l’aide de Scale Out Manager ou en appelant la procédure stockée [catalog].[add_execution_worker].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].

Ce paramètre est facultatif.This parameter is optional. S’il n’est pas spécifié, sa valeur est définie sur 1.If not specified, its value is set to 1. useanyworker est de type bit.The useanyworker is bit.

[@execution_id =] execution_id[@execution_id =] execution_id
Retourne l'identificateur unique d'une instance d'exécution.Returns the unique identifier for an instance of execution. execution_id est de type bigint.The execution_id is bigint.

Notes Remarks

Une exécution est utilisée pour spécifier les valeurs de paramètre qui sont utilisées par un package pendant une instance d'exécution unique du package.An execution is used to specify the parameter values that are a package uses during a single instance of package execution.

Si une référence environnementale est spécifiée avec le paramètre reference_id, la procédure stockée remplit les paramètres du package et du projet avec les valeurs littérales ou les valeurs référencées des variables d’environnement correspondantes.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. Si la référence environnementale est spécifiée, les valeurs de paramètre par défaut sont utilisées pendant l'exécution du package.If environment reference is specified, default parameter values are used during package execution. Pour déterminer exactement quelles valeurs sont utilisées pour une instance particulière d’exécution, utilisez la valeur du paramètre de sortie execution_id de cette procédure stockée et interrogez la vue 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.

Seuls les packages marqués comme packages de point d'entrée peuvent être spécifiés dans une exécution.Only packages that are marked as entry point packages can be specified in an execution. Si un package qui n'est pas un point d'entrée est spécifié, l'exécution échoue.If a package that is not an entry point is specified, the execution fails.

ExempleExample

L’exemple suivant appelle catalog.create_execution pour créer une instance d’exécution pour le package Child1.dtsx, qui n’est pas dans Scale Out. Project1 Integration Services contient le package.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. L'exemple appelle catalog.set_execution_parameter_value afin de définir des valeurs pour les paramètres Parameter1, Parameter2 et LOGGING_LEVEL.The example calls catalog.set_execution_parameter_value to set values for the Parameter1, Parameter2, and LOGGING_LEVEL parameters. L'exemple appelle catalog.start_execution pour démarrer une instance d'exécution.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  

Valeur du code de retourReturn Code Value

0 (succès)0 (success)

Jeux de résultatsResult Sets

NoneNone

AutorisationsPermissions

Cette procédure stockée requiert l'une des autorisations suivantes :This stored procedure requires one of the following permissions:

  • Autorisations READ et EXECUTE sur le projet et, si applicable, autorisations READ sur les environnements référencésREAD and EXECUTE permissions on the project and, if applicable, READ permissions on the referenced environment

  • Appartenance au rôle de base de données ssis_adminMembership to the ssis_admin database role

  • Appartenance au rôle serveur sysadminMembership to the sysadmin server role

    Si @runinscaleout a pour valeur 1, cette procédure stockée requiert l’une des autorisations suivantes :If @runinscaleout is 1, the stored procedure requires one of the following permissions:

  • Appartenance au rôle de base de données ssis_adminMembership to the ssis_admin database role

  • Appartenance au rôle de base de données ssis_cluster_executorMembership to the ssis_cluster_executor database role

  • Appartenance au rôle serveur sysadminMembership to the sysadmin server role

Erreurs et avertissementsErrors and Warnings

La liste suivante décrit quelques conditions qui peuvent générer une erreur ou un avertissement :The following list describes some conditions that can raise an error or warning:

  • Le package n’existe pas.The package does not exist.

  • L’utilisateur n’a pas les autorisations appropriées.The user does not have the appropriate permissions.

  • La référence environnementale, reference_id, n’est pas valide.The environment reference, reference_id, is not valid.

  • Le package spécifié n'est pas un package de point d'entrée.The package that is specified is not an entry point package.

  • Le type de données de la variable d'environnement référencée est différent du type de données du paramètre du projet ou du package.The data type of the referenced environment variable is different from the data type of the project or package parameter.

  • Le projet ou le package contient des paramètres qui requièrent des valeurs, mais aucune valeur n'a été affectée.The project or package contains parameters that require values, but no values have been assigned.

  • Les variables d’environnement référencées ne peuvent pas être trouvées dans l’environnement spécifié par la référence environnementale, reference_id.The referenced environment variables cannot be found in the environment that the environment reference, reference_id, specifies.

Voir aussiSee Also

catalog.start_execution (base de données SSISDB) catalog.start_execution (SSISDB Database)
catalog.set_execution_parameter_value (base de données SSISDB)catalog.set_execution_parameter_value (SSISDB Database)
catalog.add_execution_worker (base de données SSISDB)catalog.add_execution_worker (SSISDB Database)