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


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

Применимо к: SQL Server Integration Runtime служб SSIS в Фабрика данных Azure

Применимо к:SQL Server

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

Синтаксис

catalog.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 имеет тип nvarchar(128) .

[@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 (успешное завершение)

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

None

Разрешения

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

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