catalog.set_execution_parameter_value (base de données SSISDB)catalog.set_execution_parameter_value (SSISDB Database)

CETTE RUBRIQUE S’APPLIQUE À : ouiSQL Server (à partir de la version 2012)nonAzure SQL DatabasenonAzure SQL Data WarehousenonParallel Data Warehouse 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 ServicesIntegration Services.Sets the value of a parameter for an instance of execution in the Integration ServicesIntegration Services catalog.

Une valeur de paramètre ne peut pas être modifiée après qu'une instance d'exécution a commencé.A parameter value cannot be changed after an instance of execution has started.

SyntaxeSyntax

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

ArgumentsArguments

[ @execution_id = ] execution_id[ @execution_id = ] execution_id
Identificateur unique de l'instance d'exécution.The unique identifier for the instance of execution. execution_id est de type bigint.The execution_id is bigint.

[ @object_type = ] object_type[ @object_type = ] object_type
Type de paramètre.The type of parameter.

Pour les paramètres suivants, affectez la valeur 50 à object_typeFor the following parameters, set object_type to 50

  • LOGGING_LEVELLOGGING_LEVEL

  • CUSTOMIZED_LOGGING_LEVELCUSTOMIZED_LOGGING_LEVEL

  • DUMP_ON_ERRORDUMP_ON_ERROR

  • DUMP_ON_EVENTDUMP_ON_EVENT

  • DUMP_EVENT_CODEDUMP_EVENT_CODE

  • CALLER_INFOCALLER_INFO

  • SYNCHRONIZEDSYNCHRONIZED

    Utilisez la valeur 20 pour indiquer un paramètre du projet ou la valeur 30 pour indiquer un paramètre du package.Use the value 20 to indicate a project parameter or the value 30 to indicate a package parameter.

    object_type est de type smallint.The object_type is smallint.

    [ @parameter_name = ] parameter_name[ @parameter_name = ] parameter_name
    Nom du paramètre.The name of the parameter. parameter_name est de type nvarchar(128).The parameter_name is nvarchar(128).

    [ @parameter_value = ] parameter_value[ @parameter_value = ] parameter_value
    Valeur du paramètre.The value of the parameter. parameter_value est de type sql_variant.The parameter_value is sql_variant.

NotesRemarks

Pour découvrir les valeurs de paramètre utilisées pour une exécution donnée, interrogez la vue catalog.execution_parameter_values.To find out the parameter values that were used for a given execution, query the catalog.execution_parameter_values view.

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.To specify the scope of information that is logged during a package execution, set parameter_name to LOGGING_LEVEL and set parameter_value to one of the following values.

Définissez le paramètre object_type sur 50.Set the object_type parameter to 50.

ValeurValue DescriptionDescription
00 AucuneNone

La journalisation est désactivée.Logging is turned off. Seul l'état d'exécution du package est enregistré.Only the package execution status is logged.
11 BasicBasic

Tous les événements sont enregistrés, sauf les événements personnalisés et de diagnostic.All events are logged, except custom and diagnostic events. Ceci est la valeur par défaut.This is the default value.
22 PerformancePerformance

Seules les statistiques de performances, et les événements OnError et OnWarning, sont enregistrés.Only performance statistics, and OnError and OnWarning events, are logged.
33 CommentairesVerbose

Tous les événements sont enregistrés, y compris les événements personnalisés et de diagnostic.All events are logged, including custom and diagnostic events.
Les événements personnalisés sont notamment ces événements consignés par les tâches Integration Services.Custom events include those events that are logged by Integration Services tasks. Pour plus d’informations, consultez Messages personnalisés pour la journalisation.For more information, see Custom Messages for Logging
44 Lignage de l’exécutionRuntime lineage

Collecte les données nécessaires au suivi du lignage dans le flux de données.Collects the data required to track lineage in the data flow.
100100 Niveau de journalisation personnaliséeCustom logging level

Spécifiez les valeurs du paramètre CUSTOMIZED_LOGGING_LEVEL.Specify the settings in the CUSTOMIZED_LOGGING_LEVEL parameter. Pour plus d’informations sur les valeurs que vous pouvez spécifier, consultez catalog.create_customized_logging_level.For more info about the values that you can specify, see 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.For more info about customized logging levels, see Enable Logging for Package Execution on the SSIS Server.

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.To specify that the Integration Services server generates dump files when any error occurs during a package execution, set the following parameter values for an execution instance that hasn’t run.

ParamètreParameter ValeurValue
execution_idexecution_id Identificateur unique de l'instance d'exécutionThe unique identifier for the instance of execution
object_typeobject_type 5050
parameter_nameparameter_name ‘DUMP_ON_ERROR‘DUMP_ON_ERROR
parameter_valueparameter_value 11

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.To specify that the Integration Services server generates dump files when events occur during a package execution, set the following parameter values for an execution instance that hasn’t run.

ParamètreParameter ValeurValue
execution_idexecution_id Identificateur unique de l'instance d'exécutionThe unique identifier for the instance of execution
object_typeobject_type 5050
parameter_nameparameter_name ‘DUMP_ON_EVENT‘DUMP_ON_EVENT
parameter_valueparameter_value 11

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.To specify the events during package execution that cause the Integration Services server to generate dump files, set the following parameter values for an execution instance that hasn’t run. Séparez plusieurs codes d'événement à l'aide d'un point-virgule.Separate multiple event codes using a semi-colon.

ParamètreParameter ValeurValue
execution_idexecution_id Identificateur unique de l'instance d'exécutionThe unique identifier for the instance of execution
object_typeobject_type 5050
parameter_nameparameter_name DUMP_EVENT_CODEDUMP_EVENT_CODE
parameter_valueparameter_value Un ou plusieurs codes d'événementOne or more event codes

ExempleExample

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.The following example specifies that the Integration Services server generates dump files when any error occurs during a package execution.

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  

ExempleExample

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.The following example specifies that the Integration Services server generates dump files when events occur during a package execution, and specifies the event that causes the server to generate the files.

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 retourReturn Code Value

0 (succès)0 (success)

Jeux de résultatsResult Sets

AucuneNone

PermissionsPermissions

Cette procédure stockée requiert l'une des autorisations suivantes :This stored procedure requires one of the following permissions:

  • Autorisations READ et MODIFY sur l'instance d'exécutionREAD and MODIFY permissions on the instance of execution

  • Appartenance au rôle de base de données ssis_adminMembership to the ssis_admin database role

  • Appartenance au rôle serveur sysadminMembership to the sysadmin server role

Erreurs et avertissementsErrors and Warnings

La liste suivante décrit quelques conditions qui peuvent générer une erreur ou un avertissement :The following list describes some conditions that may raise an error or warning:

  • L’utilisateur n’a pas les autorisations appropriéesThe user does not have the appropriate permissions

  • L'identificateur d'exécution n'est pas valide.The execution identifier is not valid

  • Le nom du paramètre n'est pas valide.The parameter name is not valid

  • Le type de données de la valeur de paramètre ne correspond pas au type du paramètre.The data type of the parameter value does not match the data type of the parameter

Voir aussiSee Also

catalog.execution_parameter_values (base de données SSISDB) catalog.execution_parameter_values (SSISDB Database)
Générer de fichiers de vidage pour l’exécution des packagesGenerating Dump Files for Package Execution