catalog.set_object_parameter_value(SSISDB 数据库)

适用于:yesSQL Server(所有支持的版本)yes Azure 数据工厂中的 SSIS Integration Runtime

适用于:yesSQL 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_typesmallInt

[@folder_name =] folder_name
包含参数的文件夹的名称。 folder_namenvarchar(128)

[@project_name =] project_name
包含参数的项目的名称。 project_namenvarchar(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,则存储过程返回一个错误并且终止。