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


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

Задает значение параметра в каталоге служб Службы 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 не указано, хранимая процедура вернет сообщение об ошибке и прекратит выполнение.