catalog.create_environment_variable (base de données SSISDB)

Article
05/07/2013

Crée une variable d'environnement dans le catalogue Integration Services.

Syntaxe

create_environment_variable [ @folder_name = ] folder_name
    , [ @environment_name = ] environment_name
    , [ @variable_name = ] variable_name
    , [ @data_type = ] data_type
    , [ @sensitive = ] sensitive
    , [ @value = ] value
    , [ @description = ] description

Arguments

[ @folder\_name = ] folder_name
Nom du dossier qui contient l'environnement. folder_name est nvarchar(128).
[@ environment_name =] environment_name
Nom de l'environnement. environment_name est nvarchar(128).
[ @variable\_name = ] variable_name
Nom de la variable d'environnement. variable_name est nvarchar(128).
[ @data\_type = ] data_type
Type de données de la variable. Les types de données de variable d'environnement pris en charge incluent Boolean, Byte, DateTime, Double, Int16, Int32, Int64, Single, String, UInt32et UInt64. Les types de données de variable d'environnement non pris en charge incluent Char, DBNull, Object et Sbyte. Le type de données du paramètre data_type est nvarchar(128).
[ @sensitive = ] sensitive
Indique si la variable contient une valeur sensible ou pas. Utilisez une valeur de 1 pour indiquer que la valeur de la variable d'environnement est sensible ou une valeur de 0 pour indiquer qu'elle n'est pas sensible. Une valeur sensible est chiffrée lorsqu'elle est stockée. Une valeur qui n'est pas sensible est stockée en texte en clair. Sensitive est bit.
[ @value = ] value
Valeur de la variable d'environnement. value est sql_variant.
[ @description = ] description
Description de la variable d'environnement. value est nvarchar(1024).

Valeurs des codes de retour

0 (succès)

Jeux de résultats

Aucun

Autorisations

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

Autorisations READ et MODIFY sur l'environnement
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 :

Le nom du dossier, le nom de l'environnement ou la variable d'environnement n'est pas valide
Le nom de variable existe déjà dans l'environnement
L'utilisateur n'a pas les autorisations appropriées

Notes

Une variable d'environnement peut être utilisée pour affecter efficacement une valeur à un paramètre du projet ouà un paramètre du package pour une utilisation dans l'exécution d'un package. Les variables d'environnement permettent d'organiser les valeurs de paramètre. Les noms de variable doivent être uniques dans un environnement.

La procédure stockée valide le type de données de la variable pour s'assurer qu'elle est prise en charge par le catalogue Integration Services.

Conseil
Envisagez d'utiliser le type de données Int16 dans Integration Services au lieu du type de données Sbyte non pris en charge.

La valeur passée à cette procédure stockée avec le paramètre value sera convertie d'un type de données Integration Services en un type de données SQL Server selon le tableau suivant :

Type de données Integration Services	Type de données de SQL Server
Boolean	bit
Byte	binary, varbinary
DateTime	datetime, datetime2, datetimeoffset, smalldatetime
Double	Numérique exact : decimal, numeric ; numérique approximatif : float, real
Int16	smallint
Int32	int
Int64	bigint
Single	Numérique exact : decimal, numeric ; numérique approximatif : float, real
String	varchar, nvarchar, char
UInt32	int (C'est le mappage le plus proche de Uint32.)
UInt64	bigint (C'est le mappage le plus proche de Uint64.)

Partager via