SSISDB5：Parameter

Parameter 是Package 给外部提供的接口，通过修改Parameter，能够控制Package执行的属性，产生不同的结果。Parameter 有三种值：design_default_value，Default_Value 和 Execution_Value。

1，design_default_value是project 部署前，designer 设置的parameter的默认值。

2，Default_Value 是project 部署到SSISDB后，Parameters的默认值，如果不对Parameters进行修改，Default_Value  和 design_default_value是相同的。可以在Integration Services Catalog中，选中Project->右击Configure，修改Parameters的Default_Value。

3，Execution_Value是package 执行时，Package parameters的值。可以在Integration Services Catalog中，选中Project->package，右击Execute，将Parameters 的 Default_Value修改为此次执行的参数值。

4，Parameter 还可以引用Environment 中的 Variables。

参数的属性

Sensitive 是parameter的敏感性，对于敏感参数，SSIS对值进行加密

Required是Parameter的必需性，对于必需参数，在执行时，必须设置值；在Create Agent执行Package，必须显示必需参数的值。

一，在SSISDB中，从 [catalog].[object_parameters] 和 [catalog].[execution_parameter_values] 中查看 package的这三种参数值。

--object_type : 20 (project parameter), 30 (package parameter)
--value_type: V (parameter_value is a literal value),R(referencing an environment variable)
--value_set:1(the parameter value has been assigned), 0 (the parameter value has not been assigned)

select op.project_id,p.name as ProjectName,
    op.object_type,
    op.object_name,op.parameter_name,op.data_type,
    op.required,op.sensitive,
    op.design_default_value,op.default_value,
    op.value_type,op.referenced_variable_name,
    op.value_set
from [catalog].[object_parameters] op with(NOLOCK)
inner join catalog.projects p with(nolock)
    on op.project_id=p.project_id
where object_type in(20,30)

二，通过TSQL 来使用参数

declare @Execution_ID bigint
exec catalog.create_execution @package_name=N‘Test.dtsx‘,
    @Execution_ID=@Execution_ID output,
    @folder_name=N‘MyProjectFloder‘,
    @project_name=N‘MyProject‘,
    @use32bitruntime=FALSE,
    @reference_id=null

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

exec catalog.start_execution @Execution_ID=@Execution_ID

三，特殊参数

SSISDB的特殊参数，用于控制Package执行时的特殊行为，这些参数的值，通过 catalog.set_execution_parameter_value 来设置。

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

LOGGING_LEVEL – Integer – 0 | 1* | 2 | 3 – Sets the logging level for this execution.  The values represent no logging, basic, performance, and verbose levels respectively.

SYNCHRONIZED - Boolean - 0 synchronous | 1 asynchronous

参考文档：《SSIS Parent-Child Architecture in Catalog Deployment Mode》

First of all, by default when executing a package using T-SQL, the package is started asynchronously.  This means that when you call the stored procedure [SSISDB].[catalog].[start_execution], the T-SQL command will return immediately (assuming you passed in a valid package name and parameters), giving no indication of either success or failure.  That’s why, on this example, I’m setting the execution parameter named SYNCHRONIZED to force the T-SQL command to wait until the package has completed execution before returning.  (Note: For additional information about execution parameters, check out this post by Phil Brammer).  Second, regardless of whether you set the SYNCHRONIZED parameter, the T-SQL command will not return an error even if the package fails.

DECLARE @execution_id BIGINT

EXEC [SSISDB].[catalog].[create_execution] @package_name = N‘ChildPkgRemote.dtsx‘
    ,@execution_id = @execution_id OUTPUT
    ,@folder_name = N‘SSIS Parent-Child‘
    ,@project_name = N‘SSIS Parent-Child Catalog Deployment - Child‘
    ,@use32bitruntime = False
    ,@reference_id = NULL

-- Set user parameter value for filename
DECLARE @filename SQL_VARIANT = N‘E:\Dropbox\Presentations\_sampleData\USA_small1.txt‘

EXEC [SSISDB].[catalog].[set_execution_parameter_value] @execution_id
    ,@object_type = 30
    ,@parameter_name = N‘pSourceFileName‘
    ,@parameter_value = @filename

-- Set execution parameter for logging level
DECLARE @loggingLevel SMALLINT = 1

EXEC [SSISDB].[catalog].[set_execution_parameter_value] @execution_id
    ,@object_type = 50
    ,@parameter_name = N‘LOGGING_LEVEL‘
    ,@parameter_value = @loggingLevel

-- Set execution parameter for synchronized
DECLARE @synchronous SMALLINT = 1

EXEC [SSISDB].[catalog].[set_execution_parameter_value] @execution_id
    ,@object_type = 50
    ,@parameter_name = N‘SYNCHRONIZED‘
    ,@parameter_value = @synchronous

-- Now execute the package
EXEC [SSISDB].[catalog].[start_execution] @execution_id

-- Show status
SELECT [status] AS [execution_status]
FROM SSISDB.CATALOG.executions
WHERE execution_id = @execution_id

参考文档：

catalog.object_parameters (SSISDB Database)

catalog.set_execution_parameter_value (SSISDB Database)

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