通过

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 任务记录的那些事件。 有关详细信息，请参阅 日志记录的自定义消息。

若要指定 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 数据库）

概念

生成包执行的转储文件