catalog.start_execution (base de données SSISDB)

 

THIS TOPIC APPLIES TO: yesSQL Server (starting with 2012)noAzure SQL DatabasenoAzure SQL Data Warehouse noParallel Data Warehouse

Démarre une instance d'exécution dans le catalogue Integration Services.

start_execution [ @execution_id = ] execution_id  

[ @execution_id = ] execution_id
Identificateur unique de l'instance d'exécution. execution_id est bigint.

Une exécution est utilisée pour spécifier les valeurs de paramètre qui seront utilisées par un package pendant une instance d'exécution unique du package. Le projet correspondant peut être redéployé une fois une instance d'exécution créée et avant son démarrage. Dans ce cas, l'instance d'exécution référencera un projet obsolète. Cela provoquera l'échec de la procédure stockée.

System_CAPS_ICON_note.jpg Remarque


Les exécutions peuvent être démarrées uniquement une fois. Pour démarrer une instance d'exécution, elle doit avoir l'état Created (valeur 1 dans la colonne status de la vue catalog.operations).

L'exemple suivant appelle catalog.create_execution pour créer une instance d'exécution pour le package Child1.dtsx. Project1 Integration Services contient le package. L'exemple appelle catalog.set_execution_parameter_value afin de définir des valeurs pour les paramètres Parameter1, Parameter2 et LOGGING_LEVEL. L'exemple appelle catalog.start_execution pour démarrer une instance d'exécution.

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  
  

0 (réussite)

None

Cette procédure stockée requiert l'une des autorisations suivantes :

  • Autorisations READ et MODIFY sur l'instance d'exécution, autorisations READ et EXECUTE sur le projet, et si applicable, autorisations READ sur l'environnement référencé

  • Appartenance au rôle de base de données ssis_admin

  • Appartenance au rôle de serveur sysadmin

La liste suivante décrit quelques conditions qui peuvent générer une erreur ou un avertissement :

  • L'utilisateur n'a pas les autorisations appropriées

  • L'identificateur d'exécution n'est pas valide.

  • L'exécution a déjà démarré, ou a déjà été effectuée ; les exécutions peuvent être démarrées une seule fois

  • La référence environnementale associée au projet n'est pas valide

  • Les valeurs de paramètre obligatoires n'ont pas été définies

  • La version du projet associée à l'instance d'exécution est obsolète ; seule la version la plus actuelle d'un projet peut être exécutée

Ajouts de la communauté

Afficher: