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

Статья
05/08/2013

Создает ссылку на среду для проекта в каталоге служб Службы 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

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

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

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

Замечания

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

Поделиться через