catalog.set_execution_parameter_value (base de données SSISDB)

 

THIS TOPIC APPLIES TO: yesSQL Server (starting with 2012)noAzure SQL DatabasenoAzure SQL Data Warehouse noParallel Data Warehouse

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

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

[ @execution_id =] execution_id
Identificateur unique de l'instance d'exécution. Le execution_id est bigint.

[ @object_type =] object_type
Le type de paramètre.

Pour les paramètres suivants, définissez object_type à 50

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

Le object_type est smallint.

[ @parameter_name =] nom_paramètre
Nom du paramètre. Le nom_paramètre est nvarchar (128).

[ @parameter_value =] valeur_paramètre
Valeur du paramètre. Le valeur_paramètre 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 consignées au cours de l’exécution du package, définissez nom_paramètre LOGGING_LEVEL et ensemble valeur_paramètre à une des valeurs suivantes.

Définir le object_type paramètre à 50.

ValeurDescription
0Aucune

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

Tous les événements sont enregistrés, sauf les événements personnalisés et de diagnostic. Ceci est la valeur par défaut.
2Performance

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

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 la page pour la journalisation des Messages personnalisés
4Lignage de l’exécution

Collecte les données requises pour effectuer le suivi de lignage dans le flux de données.
100Niveau de journalisation personnalisés

Spécifiez les paramètres dans le 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 de l’exécution du Package sur le serveur SSIS.

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ètreValeur
execution_idIdentificateur unique de l'instance d'exécution
object_type50
parameter_name‘DUMP_ON_ERROR
parameter_value1

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ètreValeur
execution_idIdentificateur unique de l'instance d'exécution
object_type50
parameter_name‘DUMP_ON_EVENT
parameter_value1

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ètreValeur
execution_idIdentificateur unique de l'instance d'exécution
object_type50
parameter_nameDUMP_EVENT_CODE
parameter_valueUn ou plusieurs codes d'événement

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)

Aucune

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

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

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

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

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.

Catalog.execution_parameter_values (base de données SSISDB)
Génération de fichiers de vidage pour l’exécution du Package

Ajouts de la communauté

AJOUTER
Afficher: