catalog.set_environment_reference_type (base de données SSISDB)

Définit le type de référence et le nom de l'environnement associés à une référence environnementale existante pour un projet dans le catalogue Integration Services.

Syntaxe

set_environment_reference_location [ @reference_id = reference_id
    , [ @reference_type = ] reference_type
 [  , [ @environment_folder_name = ] environment_folder_name ]

Arguments

  • [ @reference\_id = ] reference_id
    Identificateur unique de la référence environnementale qui sera mise à jour. Le reference_id est bigint.

  • [ @reference\_type = ] reference_type
    Indique si l'environnement peut se trouver dans le même dossier que le projet (référence relative) ou dans un dossier différent (référence absolue). Utilisez la valeur R pour indiquer une référence relative. Utilisez la valeur A pour indiquer une référence absolue. Le paramètre reference_type est de type char(1).

  • [@ environment_folder_name =] environment_folder_name
    Dossier dans lequel l'environnement se trouve. Cette valeur est obligatoire pour les références absolues. environment_folder_name est nvarchar(128).

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 le projet, et autorisation READ 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

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

  • Une référence absolue est spécifiée en utilisant le caractère A dans le paramètre reference_location, mais le nom du dossier n'a pas été spécifié avec le paramètre environment_folder_name.

Notes

Un projet peut avoir des références environnementales relatives ou absolues. Les références relatives font référence à l'environnement par nom et requièrent qu'il réside dans le même dossier que le projet. Les références absolues font référence à l'environnement par nom et par dossier et peuvent faire référence aux environnements qui résident dans un dossier différent que le projet. Un projet peut référencer plusieurs environnements.

Important

Si une référence relative est spécifiée, la valeur de paramètre environment_folder_name n'est pas utilisée, et le nom du dossier d'environnement est défini automatiquement sur NULL. Si une référence absolue est spécifiée, le nom du dossier d'environnement doit être fourni dans le paramètre environment_folder_name.