catalog.create_environment_reference (база данных SSISDB)

  • Статья

Применимо к: SQL Server Integration Runtime служб SSIS в Фабрика данных Azure

Применимо к:SQL Server

Создает ссылку на среду для проекта в каталоге служб Службы Integration Services.

Синтаксис

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 ]

Аргументы

[ @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_type = ] reference_type
Указывает, может среда находиться в той же папке, что и проект (относительная ссылка), или в другой папке (абсолютная ссылка). Значение R указывает, что ссылка относительная. Значение A указывает, что ссылка абсолютная. Параметр reference_type имеет тип char(1) .

[ @environment_folder_name = ] environment_folder_name
Имя папки, в которой находится среда, на которую указывает ссылка. Это значение требуется для абсолютных ссылок. Параметр environment_folder_name имеет тип nvarchar(128) .

[ @reference_id = ] reference_id
Возвращает уникальный идентификатор для новой ссылки. Это необязательный параметр. Параметр reference_id имеет тип bigint.

Значения кодов возврата

0 (успешное завершение)

Результирующие наборы

None

Разрешения

Эта хранимая процедура требует применения одного из следующих разрешений:

  • Разрешения READ и MODIFY на проект и разрешение READ на среду

  • Членство в роли базы данных ssis_admin

  • Членство в роли сервера sysadmin

Ошибки и предупреждения

Следующий список содержит описания некоторых условий, которые могут вызвать ошибку или предупреждение.

  • Недопустимое имя папки

  • Недопустимое имя проекта

  • Пользователь не имеет соответствующих разрешений.

  • Задана абсолютная ссылка с помощью символа A в параметре reference_location, но имя папки в параметре environment_folder_name не указано.

Remarks

Проект может иметь относительные или абсолютные ссылки на среду. Относительные ссылки указывают среду по имени и требуют, чтобы она находилась в той же папке, что и проект. Абсолютные ссылки указывают среду с применением имени и папки и могут указывать среды, находящиеся в иной папке, чем проект. Проект может ссылаться на несколько сред.