SSISDB5：使用TSQL脚本执行Package

该SP创建Package的执行实例，以输出（output）参数返回执行实例的ID。

二，传递参数

向执行实例传递参数是可选的步骤，参数分为Package参数和系统参数，系统参数控制Packag的行为，如果参数@object_type的值为50，表示为执行实例设置系统参数。

--set package parameter
declare @var0 sql_variant=N‘Package_Parameter_value‘;
exec catalog.set_execution_parameter_value 
    @Execution_ID=@Execution_ID,
    @object_type=30,        --Package parameter
    @parameter_name=N‘Package_Parameter_Name‘,
    @parameter_value=@var0

--set system parameter
declare @var1 smallint = 1
exec [SSISDB].[catalog].[set_execution_parameter_value] 
    @execution_id=@execution_id,  
    @object_type=50,        --system parameter
    @parameter_name=N‘LOGGING_LEVEL‘, 
    @parameter_value=@var1
exec [SSISDB].[catalog].[start_execution] @execution_id

使用存储过程 catalog.set_execution_parameter_value 来修改参数的执行值（Execution Value）：

catalog.set_execution_parameter_value 
      [ @execution_id = execution_id
    , [ @object_type = ] object_type
    , [ @parameter_name = ] parameter_name
    , [ @parameter_value = ] parameter_value

参数 @object_type的值是20、30 和50，分别表示工程级别的参数（Project Parameter），包级别的参数（Package Parameter），以及系统参数；

参数 @parameter_name 是参数的名称，对于系统参数，共有以下7个：

• LOGGING_LEVEL
• CUSTOMIZED_LOGGING_LEVEL
• DUMP_ON_ERROR
• DUMP_ON_EVENT
• DUMP_EVENT_CODE
• CALLER_INFO
• SYNCHRONIZED

参数@parameter_value是参数的值，例如，设置@object_type=50，@parameter_name=‘SYNCHRONIZED’，@parameter_value为1，表示以同步方式启动执行实例。

三，开始执行实例

为执行实例传递相应的参数之后，可以调用SP运行Package的执行实例。在实例的脚本中，由于没有启用同步模式（设置系统参数：SYNCHRONIZED为1），因此，该SP以异步方式执行Package，不等Package执行完成，该SP就立即返回。

exec catalog.start_execution @Execution_ID=@Execution_ID
go

四，执行实例的运行模式

SSIS 引擎默认以异步方式执行Package，这意味着，在调用SP：catalog.start_execution 开始执行实例之后，SP不等待package执行完成，立即返回，返回的结果值表示调用Package的结果。如果后续执行的Package必须在前一个Package执行完成之后才能开始运行，那么，必须以同步方式执行Package，所谓同步模式，就是说，在调用sp：catalog.start_execution 之后，SP不会立即返回，而是等package执行完成之后，SP才会返回，将控制权传递到下一条TSQL 语句。

参数 SYNCHRONIZED 控制Package的执行模式，是以同步，还是以异步方式执行，该参数的默认值是0，也就是说，禁用同步模式，通过把参数:SYNCHRONIZED 的执行值（Execution Value）修改为1，使SSIS Engine以同步方式执行Package：

exec catalog.set_execution_parameter_value 
                @execution_id=@package_execution_instance_id, 
                @object_type= 50, 
                @parameter_name = N‘SYNCHRONIZED‘, 
                @parameter_value = 1;

SYNCHRONIZED是一个系统参数，参数@object_type必须设置为50，当设置参数SYNCHRONIZED的执行值（Execution Value）为1，存储过程：catalog.start_execution 等到Package执行完成之后返回。

参考文档：

Quick Tip – Run SSIS 2012 packages synchronously and other execution parameters

catalog.create_execution (SSISDB Database)

catalog.start_execution (SSISDB Database)

catalog.set_execution_parameter_value (SSISDB Database)

catalog.executions (SSISDB Database)

SSISDB5：使用TSQL脚本执行Package

标签：create   结果   runtime   book   etl   模式   赋值   sql   数据