catalog.start_execution (base de données SSISDB)

  • Article

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

Syntaxe

start_execution [ @execution_id = ] execution_id

Arguments

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

Notes

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.

[!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).

Exemple

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

Valeur des codes de retour

0 (réussite)

Jeux de résultats

None

Autorisations

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

Erreurs et avertissements

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