catalog.set_execution_parameter_value (base de données SSISDB)

  • Article

Définit la valeur d'un paramètre pour une instance d'exécution dans le catalogue Integration Services.

Une valeur de paramètre ne peut pas être modifiée après qu'une instance d'exécution a commencé.

Syntaxe

set_execution_parameter_value [ @execution_id = execution_id
    , [ @object_type = ] object_type
    , [ @parameter_name = ] parameter_name
    , [ @parameter_value = ] parameter_value

Arguments

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

Notes

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.

Valeur

Description

0

Aucune

La journalisation est désactivée. Seul l'état d'exécution du package est enregistré.

1

Basic

Tous les événements sont enregistrés, sauf les événements personnalisés et de diagnostic. Il s'agit de la valeur par défaut.

2

Performance

Seules les statistiques de performances, et les événements OnError et OnWarning, sont enregistrés.

3

Commentaires

Tous les événements sont enregistrés, y compris les événements personnalisés et de diagnostic.
Les événements personnalisés sont notamment ces événements consignés par les tâches Integration Services. Pour plus d'informations, consultez Messages personnalisés pour la journalisation.

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.

Paramètre

Valeur

execution_id

Identificateur unique de l'instance d'exécution

object_type

50

parameter_name

‘DUMP_ON_ERROR

parameter_value

1

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.

Paramètre

Valeur

execution_id

Identificateur unique de l'instance d'exécution

object_type

50

parameter_name

‘DUMP_ON_EVENT

parameter_value

1

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.

Paramètre

Valeur

execution_id

Identificateur unique de l'instance d'exécution

object_type

50

parameter_name

DUMP_EVENT_CODE

parameter_value

Un ou plusieurs codes d'événement

Exemple

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

Valeur des codes de retour

0 (succès)

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

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

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

Voir aussi

Référence

catalog.execution_parameter_values (base de données SSISDB)

Concepts

Générer de fichiers de vidage pour l'exécution des packages