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

Статья
11/19/2024

Область применения: среда выполнения интеграции SSIS SQL Server в Фабрика данных 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 (успешное завершение)

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

нет

Разрешения

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

Разрешения READ и MODIFY на проект и разрешение READ на среду
Членство в роли базы данных ssis_admin
Членство в роли сервера sysadmin

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

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

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

Замечания

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

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