catalog.create_environment_reference (base de données SSISDB)

  • Article

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.