catalog.set_execution_parameter_value (base de données SSISDB)

  • Article

S’applique à :SQL Server SSIS Integration Runtime dans Azure Data Factory

S’applique à :SQL Server

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

catalog.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 de type bigint.

[ @object_type = ] object_type
Type de paramètre.

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

  • LOGGING_LEVEL

  • CUSTOMIZED_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 de type smallint.

[ @parameter_name = ] parameter_name
Le nom du paramètre. parameter_name est de type nvarchar(128).

[ @parameter_value = ] parameter_value
Valeur du paramètre. parameter_value est de type 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 durant 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.

Définissez le paramètre object_type sur 50.

Valeur Description
0 None

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

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 Performances

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.
4 Lignage de l’exécution

Collecte les données nécessaires au suivi du lignage dans le flux de données.
100 Niveau de journalisation personnalisée

Spécifiez les valeurs du paramètre CUSTOMIZED_LOGGING_LEVEL. Pour plus d’informations sur les valeurs que vous pouvez spécifier, consultez catalog.create_customized_logging_level.

Pour plus d’informations sur les niveaux de journalisation personnalisée, consultez Activer la journalisation des exécutions de package sur le serveur SSIS.

Pour spécifier que le serveur Integration Services doit générer des fichiers de vidage quand 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 quand 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 pendant 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

Exemples

R. Générer des fichiers de vidage pour les erreurs

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

B. Générer des fichiers de vidage pour les événements

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 du code 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 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

catalog.execution_parameter_values (base de données SSISDB)
Générer de fichiers de vidage pour l’exécution des packages