catalog.set_execution_parameter_value（SSISDB 数据库）

  • 项目

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

适用于：SQL Server

为 Integration Services 目录中的执行实例设置参数的值。

当已开始执行实例后，就不能再更改参数值。

语法

catalog.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

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

收集跟踪数据流中的沿袭所需的数据。
100 自定义日志记录级别

指定 CUSTOMIZED_LOGGING_LEVEL 参数中的设置。 有关可指定的值的详细信息，请参阅 catalog.create_customized_logging_level。

有关自定义日志记录级别的详细信息，请参阅在 SSIS 服务器上启用包执行的日志记录。

若要指定 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 一个或多个事件代码

示例

A. 为错误生成转储文件

以下示例指定 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

B. 为事件生成转储文件

以下示例指定 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 数据库）
生成包执行的转储文件