catalog.create_environment_variable (base de données SSISDB)

 

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

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

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  

[ @folder_name =] nom_dossier
Nom du dossier qui contient l'environnement. Le nom_dossier est nvarchar (128).

[ @environment_name =] environment_name
Nom de l'environnement. Le environment_name est nvarchar (128).

[ @variable_name =] nom_variable
Nom de la variable d'environnement. Le nom_variable est nvarchar (128).

[ @data_type = ] data_type
Type de données de la variable. Prise en charge des données de variable d’environnement types incluent booléenne, octets, DateTime, Double, Int16, Int32, Int64, unique, chaîne, UInt32, et UInt64. Types de données de variable d’environnement non pris en charge incluent Char, DBNull, objet, et Sbyte. Type de données de la data_type paramètre est nvarchar (128).

[ @sensitive =] sensibles
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 brut. Sensitive is bit.

[ @value = ] value
Valeur de la variable d'environnement. Le valeur est sql_variant.

[ @description =] description
Description de la variable d'environnement. Le valeur est nvarchar (1024).

0 (succès)

Aucune

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

  • Autorisations READ et MODIFY sur l'environnement

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

  • 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

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.

System_CAPS_ICON_tip.jpg Astuce


Envisagez d’utiliser le Int16 type de données de Integration Services au lieu de la non prise en charge Sbyte type de données.

La valeur passée à cette procédure stockée avec la valeur paramètre sera converti d’une Integration Services type de données à un SQL Server type de données conformément au tableau suivant :

Type de données Integration ServicesType de données de SQL Server
Valeur booléennebits
Octetsbinaire, varbinary
Date/heuredate/heure, datetime2, datetimeoffset, smalldatetime
DoubleValeur numérique exacte : décimal, numériques; Numérique approximatif : float, réel
Int16smallint
Int32int
Int64bigint
UniqueValeur numérique exacte : décimal, numériques; Numérique approximatif : float, réel
Chaînevarchar, nvarchar, char
UInt32int (c’est le mappage le plus proche disponible à Uint32.)
UInt64bigint (c’est le mappage le plus proche disponible à Uint64.)

Ajouts de la communauté

AJOUTER
Afficher: