catalog.set_execution_parameter_value(SSISDB 数据库)
为 Integration Services 目录中的执行实例设置参数值。
当已开始执行实例后,就不能再更改参数值。
语法
set_execution_parameter_value [ @execution_id = execution_id
, [ @object_type = ] object_type
, [ @parameter_name = ] parameter_name
, [ @parameter_value = ] parameter_value
参数
[ @execution\_id = ] execution_id
执行实例的唯一标识符。 execution_id 的数据类型为 bigint。[ @object\_type = ] object_type
参数的类型。对于以下参数,请将 object_type 设置为 50
LOGGING_LEVEL
DUMP_ON_ERROR
DUMP_ON_EVENT
DUMP_EVENT_CODE
CALLER_INFO
SYNCHRONIZED
使用值 20 表示项目参数,使用值 30 表示包参数。
object_type 的数据类型为 smallint。
[ @parameter\_name = ] parameter_name
参数的名称。 parameter_name 的数据类型为 nvarchar(128)。[ @parameter\_value = ] parameter_value
参数值。 parameter_value 的数据类型为 sql_variant。
备注
要查找用于给定执行的参数值,请查询 catalog.execution_parameter_values 视图。
要指定在包执行期间记录的信息范围,请将 parameter_name 设置为 LOGGING_LEVEL 并将 parameter_value 设置为以下值之一:
将 object_type 参数设置为 50。
值 |
说明 |
---|---|
0 |
无 关闭日志记录。 仅记录包执行状态。 |
1 |
基本 除了自定义事件和诊断事件之外,记录其余所有事件。 此为默认值。 |
2 |
性能 仅记录性能统计信息、OnError 和 OnWarning 事件。 |
3 |
详细 记录所有事件,包括自定义事件和诊断事件。 |
若要指定 Integration Services 服务器在包执行期间出现任意错误时生成转储文件,请为未运行的执行实例设置以下参数值:
参数 |
值 |
---|---|
execution_id |
执行实例的唯一标识符 |
object_type |
50 |
parameter_name |
‘DUMP_ON_ERROR |
parameter_value |
1 |
若要指定 Integration Services 服务器在包执行期间出现事件时生成转储文件,请为未运行的执行实例设置以下参数值:
参数 |
值 |
---|---|
execution_id |
执行实例的唯一标识符 |
object_type |
50 |
parameter_name |
‘DUMP_ON_EVENT |
parameter_value |
1 |
若要指定在包执行期间导致 Integration Services 服务器生成转储文件的事件,请为未运行的执行实例设置以下参数值: 使用分号分隔多个事件代码。
参数 |
值 |
---|---|
execution_id |
执行实例的唯一标识符 |
object_type |
50 |
parameter_name |
DUMP_EVENT_CODE |
parameter_value |
一个或多个事件代码 |
示例
以下示例指定 Integration Services 服务器在包执行期间出现任意错误时生成转储文件:
exec catalog.create_execution 'TR2','Recurring ETL', 'Dim_DCVendor.dtsx',NULL, 0,@execution_id out
exec catalog.set_execution_parameter_value @execution_id, 50, 'DUMP_ON_ERROR',1
以下示例指定 Integration Services 服务器在包执行期间出现事件时生成转储文件,并指定导致该服务器生成这些文件的事件:
exec catalog.create_execution 'TR2','Recurring ETL', 'Dim_DCVendor.dtsx',NULL, 0,@execution_id out
exec catalog.set_execution_parameter_value @execution_id, 50, 'DUMP_ON_EVENT',1
declare @event_code nvarchar(50)
set @event_code = '0xC020801C'
exec catalog.set_execution_parameter_value @execution_id, 50, 'DUMP_EVENT_CODE', @event_code
返回代码值
0(成功)
结果集
无
权限
此存储过程需要下列权限之一:
针对执行实例的 READ 和 MODIFY 权限
ssis_admin 数据库角色的成员身份
sysadmin 服务器角色的成员身份
错误和警告
下面的列表描述了一些可能引发错误或警告的情况:
用户不具备适当的权限
执行标识符无效
参数名称无效
参数值的数据类型与参数的数据类型不匹配
请参阅
参考
catalog.execution_parameter_values(SSISDB 数据库)