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

Статья
05/08/2013

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

Синтаксис

set_object_parameter_value [ @object_type = ] object_type 
    , [ @folder_name = ] folder_name 
    , [ @project_name = ] project_name 
    , [ @parameter_name = ] parameter _name 
    , [ @parameter_value = ] parameter_value 
 [  , [ @object_name = ] object_name ]
 [  , [ @value_type = ] value_type ]

Аргументы

[ @object\_type = ] object_type
Тип параметра. Значение 20 указывает параметр проекта, значение 30 — параметр пакета. object_type имеет значение smallInt.
[ @folder\_name = ] folder_name
Имя папки, в которой содержится параметр. folder_name имеет значение nvarchar(128).
[ @project\_name = ] project_name
Имя проекта, в котором содержится параметр. project_name имеет значение nvarchar(128).
[ @parameter\_name = ] parameter_name
Имя параметра. parameter_name имеет значение nvarchar(128).
[ @parameter\_value = ] parameter_value
Значение параметра. parameter_value имеет значение sql_variant.
[ @object\_name = ] object_name
Имя пакета. Этот аргумент обязателен, если параметр является параметром пакета. Параметр object_name имеет тип nvarchar(260).
[ @value\_type = ] value_type
Тип значения параметра. Символ V указывает, что parameter_value является литеральным значением, которое будет использоваться по умолчанию, если до исполнения не будет назначено других значений. Символ R указывает, что parameter_value является указанным в ссылке значением и что ему было задано имя переменной среды. Этот аргумент является необязательным. По умолчанию используется символ V. value_type имеет значение char(1).

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

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

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

Нет

Разрешения

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

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

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

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

Недопустимый тип параметра.
Недопустимое имя проекта
Недопустимое имя пакета для параметров пакета.
Недопустимый тип значения.
Пользователь не имеет соответствующих разрешений

Замечания

Если никакое значение value_type не указано, то по умолчанию используется литеральное значение parameter_value. Если используется литеральное значение, параметру value_set в отображении object_parameters присваивается значение 1. Значение NULL недопустимо.
Если value_type содержит символ R, обозначающий указанное в ссылке значение, то parameter_value ссылается на имя переменной среды.
Значение 20 можно использовать в object_type для обозначения параметра проекта. В этом случае значение object_name не является обязательным и любое значение, указанное для object_name, будет пропущено. Это значение используется, когда пользователь хочет задать параметр проекта.
Значение 30 можно использовать в object_type для обозначения параметра пакета. В этом случае значение object_name используется для обозначения соответствующего пакета. Если значение object_name не указано, хранимая процедура вернет сообщение об ошибке и прекратит выполнение.

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