catalog.create_environment_reference (base de données SSISDB)

  • Article

S’applique à :SQL Server SSIS Integration Runtime dans Azure Data Factory

S’applique à :SQL Server

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

Syntaxe

catalog.create_environment_reference [ @folder_name = ] folder_name  
     , [ @project_name = ] project_name  
     , [ @environment_name = ] environment_name  
     , [ @reference_type = ] reference_type  
  [  , [ @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 de type nvarchar(128) .

[ @project_name = ] project_name
Nom du projet qui référence l'environnement. project_name est de type nvarchar(128) .

[ @environment_name = ] environment_name
Nom de l'environnement référencé. environment_name est de type nvarchar(128) .

[ @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. reference_type est de type 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 de type nvarchar(128) .

[ @reference_id = ] reference_id
Retourne l'identificateur unique de la nouvelle référence. Ce paramètre est facultatif. reference_id est de type bigint.

Valeur du code de retour

0 (succès)

Jeux de résultats

None

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 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.