catalog.create_environment_reference (base de données SSISDB)

Article
05/07/2013

Crée une référence environnementale pour un projet dans le catalogue Integration Services.

Syntaxe

create_environment_reference [ @folder_name = ] folder_name
     , [ @project_name = ] project_name
     , [ @environment_name = ] environment_name
     , [ @reference_location = ] reference_location
  [  , [ @environment_folder_name = ] environment_folder_name ]
  [  , [ @reference_id = ] reference_id OUTPUT ]

Arguments

[ @folder\_name = ] folder_name
Nom du dossier du projet qui référence l'environnement. folder_name est nvarchar(128).
[ @project\_name = ] project_name
Nom du projet qui référence l'environnement. project_name est nvarchar(128).
[@ environment_name =] environment_name
Nom de l'environnement référencé. environment_name est nvarchar(128).
[@ reference_location =] reference_location
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. reference_location est char(1).
[@ environment_folder_name =] environment_folder_name
Nom du dossier dans lequel l'environnement référencé se trouve. Cette valeur est obligatoire pour les références absolues. environment_folder_name est nvarchar(128).
[ @reference\_id = ] reference_id
Retourne l'identificateur unique de la nouvelle référence. Ce paramètre est facultatif. reference_id est bigint.

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 n'est pas valide.
Le nom du projet 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.

Partager via