catalog.create_environment_reference（SSISDB 数据库）

在 Integration Services 目录中为项目创建环境引用。

语法

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 ]

参数

• [ @folder\_name = ] folder_name
  正在引用环境的项目的文件夹名称。 folder_name 的数据类型为 nvarchar(128)。

• [ @project\_name = ] project_name
  正在引用环境的项目的名称。 project_name 的数据类型为 nvarchar(128)。

• [ @environment\_name = ] environment_name
  被引用环境的名称。 environment_name 的数据类型为 nvarchar(128)。

• [ @reference\_location = ] reference_location
  指示环境是可以位于与项目相同的文件夹中（相对引用），还是位于其他文件夹中（绝对引用）中。 使用值 R 指示相对引用。 使用值 A 指示绝对引用。 reference_location 的数据类型为 char(1)。

• [ @environment\_folder\_name = ] environment_folder_name
  被引用的环境所在的文件夹的名称。 此值对于绝对引用是必需的。 environment_folder_name 的数据类型为 nvarchar(128)。

• [ @reference\_id = ] reference_id
  返回新引用的唯一标识符。 此参数可选。 reference_id 的数据类型为 bigint。

返回代码值

0（成功）

结果集

无

权限

此存储过程需要下列权限之一：

• 针对项目的 READ 和 MODIFY 权限，以及针对环境的 READ 权限

• ssis_admin 数据库角色的成员身份

• sysadmin 服务器角色的成员身份

错误和警告

下面的列表描述了一些可能引发错误或警告的情况：

• 文件夹名称无效

• 项目名称无效

• 用户不具备适当的权限

• 通过在 reference_location 参数中使用 A 字符来指定绝对引用，而未使用 environment_folder_name 参数指定该文件夹的名称。

注释

项目可以具有相对或绝对的环境引用。 相对引用通过名称引用环境，并要求它与项目位于相同文件夹中。 绝对引用通过名称和文件夹引用环境，可能引用与项目不在同一文件夹中的环境。 项目可以引用多个环境。