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

Статья
01/02/2025

Область применения:среда выполнения интеграции SSIS SQL Server в Фабрика данных Azure

Область применения:SQL Server

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

Синтаксис

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

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