catalog.create_execution (base de données SSISDB)

 

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 Services.

Cette procédure stockée utilise le niveau de journalisation par défaut du serveur.

create_execution [ @folder_name = folder_name  
     , [ @project_name = ] project_name  
     , [ @package_name = ] package_name  
  [  , [ @reference_id = ] reference_id ]  
  [  , [ @use32bitruntime = ] use32bitruntime ] 
  [  , [ @runincluster = ] runincluster ]
  [  , [ @useanyworker = ] useanyworker ] 
     , [ @execution_id = ] execution_id OUTPUT  

[ @folder_name =] nom_dossier
Nom du dossier qui contient le package qui sera exécuté. Le nom_dossier est nvarchar (128).

[ @project_name =] project_name
Le nom du projet qui contient le package doit être exécutée. Le project_name est nvarchar (128).

[ @package_name =] package_name
Nom du package qui sera exécuté. Le package_name est nvarchar (260).

[ @reference_id =] reference_id
Identificateur unique d'une référence environnementale. Ce paramètre est facultatif. Le reference_id est bigint.

[ @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. Utilisez la valeur 1 pour exécuter le package avec le runtime 32 bits lors de l’exécution sur un système d’exploitation 64 bits. 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é. Ce paramètre est facultatif. Le Use32bitruntime est bits.

[ @runincluster =] runincluster
Indique si l’exécution est de montée en puissance parallèle. Utilisez la valeur 1 pour exécuter le package dans la montée en puissance parallèle. Utilisez la valeur 0 pour exécuter le package sans montée en puissance parallèle. Ce paramètre est facultatif. Il est défini sur 0, ne sont pas spécifié. Le runincluster est bits.

[ @useanyworker =] useanyworker
Indique si tout l’échelle des processus de travail est autorisé à effectuer l’exécution. Utilisez la valeur 1 pour exécuter le package avec tout mettre à l’échelle des processus de travail. Utilisez la valeur 0 pour indiquer que l’échelle pas toutes des travailleurs sont autorisés à exécuter le package. Ce paramètre est facultatif. Elle est définie sur 1, ne sont pas spécifié. Le useanyworker est bits.

[ @execution_id =] execution_id
Retourne l'identificateur unique d'une instance d'exécution. Le execution_id est bigint.

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.

Si une référence environnementale est spécifiée avec la reference_id paramètre, la procédure stockée remplit les paramètres de projet et de package avec des valeurs littérales ou des valeurs référencées dans les variables d’environnement correspondantes. 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. Pour déterminer exactement quelles valeurs sont utilisées pour une instance particulière de l’exécution, utilisez la execution_id paramètre de sortie à partir de cette procédure stockée requête le execution_parameter_values affichage.

Seuls les packages marqués comme packages de point d'entrée peuvent être spécifiés dans une exécution. Si un package qui n'est pas un point d'entrée est spécifié, l'exécution échoue.

L’exemple suivant appelle catalog.create_execution pour créer une instance d’exécution du package Child1.dtsx, qui n’est pas montée en puissance parallèle. 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 (succès)

Aucune

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

  • Autorisations READ et EXECUTE sur le projet et, si applicable, autorisations READ sur les environnements référencés

  • L’appartenance à la ssis_admin rôle de base de données

  • L’appartenance à la sysadmin rôle de serveur

Si @runincluster est 1, la procédure stockée requiert l’une des autorisations suivantes :

  • L’appartenance à la ssis_admin rôle de base de données

  • L’appartenance à la ssis_cluster_executor rôle de base de données

  • L’appartenance à la sysadmin rôle de serveur

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

  • Le package n’existe pas.

  • L’utilisateur n’a pas les autorisations appropriées.

  • La référence environnementale, reference_id, n’est pas valide.

  • Le package spécifié n'est pas un package de point d'entrée.

  • 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.

  • Le projet ou le package contient des paramètres qui requièrent des valeurs, mais aucune valeur n'a été affectée.

  • Les variables d’environnement référencée est introuvable dans l’environnement qui font référence à l’environnement, reference_id, spécifie.

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

Ajouts de la communauté

AJOUTER
Afficher: