catalog.create_environment_reference (base de données SSISDB)catalog.create_environment_reference (SSISDB Database)

CETTE RUBRIQUE S’APPLIQUE À : ouiSQL Server (à partir de la version 2012)nonAzure SQL DatabasenonAzure SQL Data WarehousenonParallel Data Warehouse THIS TOPIC APPLIES TO: yesSQL Server (starting with 2012)noAzure SQL DatabasenoAzure SQL Data Warehouse noParallel Data Warehouse

Crée une référence environnementale pour un projet dans le catalogue Integration ServicesIntegration Services.Creates an environment reference for a project in the Integration ServicesIntegration Services catalog.

SyntaxeSyntax

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

ArgumentsArguments

[ @folder_name = ] folder_name[ @folder_name = ] folder_name
Nom du dossier du projet qui référence l'environnement.The name of the folder of the project that is referencing the environment. folder_name est de type nvarchar(128).The folder_name is nvarchar(128).

[ @project_name = ] project_name[ @project_name = ] project_name
Nom du projet qui référence l'environnement.The name of the project that is referencing the environment. project_name est de type nvarchar(128).The project_name is nvarchar(128).

[ @environment_name = ] environment_name[ @environment_name = ] environment_name
Nom de l'environnement référencé.The name of the environment being referenced. environment_name est de type nvarchar(128).The environment_name is nvarchar(128).

[ @reference_location = ] reference_location[ @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).Indicates whether the environment can be located in the same folder as the project (relative reference) or in a different folder (absolute reference). Utilisez la valeur R pour indiquer une référence relative.Use the value R to indicate a relative reference. Utilisez la valeur A pour indiquer une référence absolue.Use the value A to indicate an absolute reference. reference_location est de type char(1).The reference_location is char(1).

[ @environment_folder_name = ] environment_folder_name[ @environment_folder_name = ] environment_folder_name
Nom du dossier dans lequel l'environnement référencé se trouve.The name of the folder in which the environment that being referenced is located. Cette valeur est obligatoire pour les références absolues.This value is required for absolute references. environment_folder_name est de type nvarchar(128).The environment_folder_name is nvarchar(128).

[ @reference_id = ] reference_id[ @reference_id = ] reference_id
Retourne l'identificateur unique de la nouvelle référence.Returns the unique identifier for the new reference. Ce paramètre est facultatif.This parameter is optional. reference_id est de type bigint.The reference_id is bigint.

Valeur du code de retourReturn Code Value

0 (succès)0 (success)

Jeux de résultatsResult Sets

AucuneNone

PermissionsPermissions

Cette procédure stockée requiert l'une des autorisations suivantes :This stored procedure requires one of the following permissions:

  • Autorisations READ et MODIFY sur le projet, et autorisation READ sur l'environnementREAD and MODIFY permissions on the project, and READ permission on the environment

  • Appartenance au rôle de base de données ssis_adminMembership to the ssis_admin database role

  • Appartenance au rôle serveur sysadminMembership to the sysadmin server role

Erreurs et avertissementsErrors and Warnings

La liste suivante décrit quelques conditions qui peuvent générer une erreur ou un avertissement :The following list describes some conditions that may raise an error or warning:

  • Le nom du dossier n'est pas valide.The folder name is not valid

  • Le nom du projet n'est pas valide.The project name is not valid

  • L'utilisateur n'a pas les autorisations appropriéesThe user does not appropriate permissions

  • 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.An absolute reference is specified by using the A character in the reference_location parameter, but the name of the folder was not specified with the environment_folder_name parameter.

NotesRemarks

Un projet peut avoir des références environnementales relatives ou absolues.A project can have relative or absolute environment references. 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.Relative references refer to the environment by name and require that it resides in the same folder as the project. 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.Absolute references refer to the environment by name and folder, and may refer to environments that reside in a different folder than the project. Un projet peut référencer plusieurs environnements.A project can reference multiple environments.