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

Задает ссылочный тип и имя среды, связанные с существующей ссылкой на среду для проекта в каталоге служб Службы Integration Services.

Синтаксис

set_environment_reference_location [ @reference_id = reference_id
    , [ @reference_type = ] reference_type
 [  , [ @environment_folder_name = ] environment_folder_name ]

Аргументы

• [ @reference\_id = ] reference_id
  Уникальный идентификатор обновляемой ссылки на среду. Параметр reference_id имеет тип bigint.

• [ @reference\_type = ] reference_type
  Указывает, может среда находиться в той же папке, что и проект (относительная ссылка), или в другой папке (абсолютная ссылка). Значение R указывает, что ссылка относительная. Значение A указывает, что ссылка абсолютная. Параметр reference_type имеет тип char(1).

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

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

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

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

Нет

Разрешения

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

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

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

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

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

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

• Недопустимое имя папки, имя среды или идентификатор ссылки.

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

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

Замечания

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

Важно!
Если указана относительная ссылка, значение параметра environment_folder_name не используется, а имени папки среды автоматически присваивается значение NULL. Если указана абсолютная ссылка, должно быть задано имя папки среды через параметр environment_folder_name.