Partager via


catalog.set_object_parameter_value (base de données SSISDB)

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

S’applique à :SQL Server

Définit la valeur d'un paramètre dans le catalogue Integration Services. Associe la valeur à une variable d’environnement ou affecte une valeur littérale qui est utilisée par défaut quand aucune autre valeur n’est affectée.

Syntaxe

catalog.set_object_parameter_value [ @object_type = ] object_type   
    , [ @folder_name = ] folder_name   
    , [ @project_name = ] project_name   
    , [ @parameter_name = ] parameter_name   
    , [ @parameter_value = ] parameter_value   
 [  , [ @object_name = ] object_name ]  
 [  , [ @value_type = ] value_type ]  

Arguments

[@object_type =] object_type
Type de paramètre. 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.

[@folder_name =] nom_dossier
Nom du dossier qui contient le paramètre. folder_name est de type nvarchar(128) .

[@project_name =] project_name
Nom du projet qui contient le paramètre. project_name est de type nvarchar(128) .

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

[@object_name =] object_name
Nom du package. Cet argument est obligatoire lorsque le paramètre est un paramètre du package. object_name est de type nvarchar(260).

[@value_type =] value_type
Type de valeur du paramètre. Utilisez le caractère V pour indiquer que parameter_value est une valeur littérale qui est utilisée par défaut quand aucune autre valeur n’est affectée avant l’exécution. Utilisez le caractère R pour indiquer que parameter_value est une valeur référencée et qu’elle a été définie sur le nom d’une variable d’environnement. Cet argument est facultatif, le caractère V est utilisé par défaut. value_type est de type char(1).

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 le projet

  • 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 de procédure stockée :

  • Le type de paramètre n'est pas valide.

  • Le nom du projet n'est pas valide.

  • Pour les paramètres du package, le nom du package n'est pas valide

  • Le type de valeur n'est pas valide.

  • L’utilisateur n’a pas les autorisations appropriées

Notes

  • Si aucun value_type n’est spécifié, une valeur littérale pour parameter_value est utilisée par défaut. Quand une valeur littérale est utilisée, le value_set dans la vue object_parameters est défini sur 1. Une valeur de paramètre NULL n'est pas autorisée.

  • Si value_type contient le caractère R, qui dénote une valeur référencée, parameter_value fait référence au nom d’une variable d’environnement.

  • La valeur 20 peut être utilisée pour object_type afin de dénoter un paramètre du projet. Dans ce cas, une valeur pour object_name n’est pas nécessaire, et toute valeur spécifiée pour object_name est ignorée. Cette valeur est utilisée lorsque l'utilisateur souhaite définir un paramètre du projet.

  • La valeur 30 peut être utilisée pour object_type afin de dénoter un paramètre du package. Dans ce cas, une valeur pour object_name est utilisée pour dénoter le package correspondant. Si object_name n’est pas spécifié, la procédure stockée retourne une erreur et termine.