catalog.set_object_parameter_value（SSISDB 数据库）

适用于：SQL Server Azure 数据工厂中的 SSIS Integration Runtime

适用于：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
包含参数的文件夹的名称。 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 使用文本值。 使用文本值时，object_parameters 视图中的 value_set 将设置为 1。 不允许 NULL 参数值。

• 如果 value_type 包含字符 R指示引用值则 parameter_value 将引用环境变量的名称。

• 值 20 可能用于 object_type 以表示项目参数。 在此情况下，object_name 的值不是必需的，将忽略为 object_name 指定的任何值。 当用户要设置项目参数时，将使用此值。

• 值 30 可能用于 object_type 以表示包参数。 在此情况下，使用 object_name 的一个值来表示相应的包。 如果未指定 object_name，则存储过程返回一个错误并且终止。