catalog.set_execution_parameter_value (base de données SSISDB)

[ @execution_id = ] execution_id

Identificateur unique de l'instance d'exécution. execution_id est bigint.

[ @object_type = ] object_type

Type de paramètre.

Pour les paramètres suivants, affectez la valeur 50 à object_type

• LOGGING_LEVEL

• DUMP_ON_ERROR

• DUMP_ON_EVENT

• DUMP_EVENT_CODE

• CALLER_INFO

• SYNCHRONIZED

Utilisez la valeur 20 pour indiquer un paramètre du projet ou la valeur 30 pour indiquer un paramètre du package.

object_type est smallint.

[ @parameter_name = ] parameter_name

Nom du paramètre. parameter_name est nvarchar(128).

[ @parameter_value = ] parameter_value

Valeur du paramètre. parameter_value est sql_variant.

Pour découvrir les valeurs de paramètre utilisées pour une exécution donnée, interrogez la vue catalog.execution_parameter_values.

Pour spécifier l'étendue des informations enregistrées lors d'une exécution de package, attribuez au paramètre parameter_name la valeur LOGGING_LEVEL et au paramètre parameter_value l'une des valeurs suivantes.

Affectez la valeur 50 au paramètre object_type.

Pour spécifier que le serveur Integration Services doit générer des fichiers de vidage lorsqu'une erreur se produit pendant une exécution de package, définissez les valeurs de paramètre suivantes pour une instance d'exécution qui n'a pas été exécutée.

Pour spécifier que le serveur Integration Services doit générer des fichiers de vidage lorsque des événements se produisent pendant une exécution de package, définissez les valeurs de paramètre suivantes pour une instance d'exécution qui n'a pas été exécutée.

Pour spécifier les événements lors d'une exécution de package qui provoquent la génération de fichiers de vidage par le serveur Integration Services, définissez les valeurs de paramètre suivantes pour une instance d'exécution qui n'a pas été exécutée. Séparez plusieurs codes d'événement à l'aide d'un point-virgule.

L'exemple suivant spécifie que le serveur Integration Services doit générer des fichiers de vidage lorsqu'une erreur se produit pendant une exécution de package.

exec catalog.create_execution  'TR2','Recurring ETL', 'Dim_DCVendor.dtsx',NULL, 0,@execution_id out
exec catalog.set_execution_parameter_value  @execution_id, 50, 'DUMP_ON_ERROR',1

L'exemple suivant spécifie que le serveur Integration Services doit générer des fichiers de vidage lorsque des événements se produisent pendant une exécution de package, et identifie l'événement qui provoque la génération des fichiers par le serveur.

exec catalog.create_execution  'TR2','Recurring ETL', 'Dim_DCVendor.dtsx',NULL, 0,@execution_id out
exec catalog.set_execution_parameter_value  @execution_id, 50, 'DUMP_ON_EVENT',1
declare @event_code nvarchar(50)
set @event_code = '0xC020801C'
exec catalog.set_execution_parameter_value  @execution_id, 50, 'DUMP_EVENT_CODE', @event_code

0 (succès)

None

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

• Autorisations READ et MODIFY sur l'instance d'exécution

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

• Le nom du paramètre n'est pas valide.

• Le type de données de la valeur de paramètre ne correspond pas au type du paramètre.

Référence

Concepts