Professional Microsoft SQL Server 2014 Integration Services (Wrox Programmer to Programmer), 1st Edition (2014)

Appendix B. SSIS Internal Views and Stored Procedures

In this appendix you find an abbreviated table of some of the stored procedures and views that may be helpful for an administrator when hacking the SSISDB catalog. For the most part, you want to use the views instead of the underlying tables since the tables may change during service packs or new versions of SQL Server. It is for this reason the tables are not in the appendix. This list is not comprehensive but focuses on the commonly used ones when you want to hack the SSIS catalog.

VIEWS

VIEW	USE
catalog.catalog_properties	Contains all the properties of the SSIS catalog.
catalog.environment_variables	Lists all the variables used by a set of environments.
catalog.environments	Contains a list of SSIS environments in folders. You may need to reference this view to see what potential environments you have when running a package through T-SQL.
catalog.executions	Each time you execute a package, a row is shown here. Shows the amount of resources being allocated to the package. Shows the duration of the package runtime, who ran the package, and from what machine.
catalog.event_messages	As a package runs, several rows are shown here for each successful run of a step.
catalog.folders	Contains a list of folders in the catalogs.
catalog.execution_data_statistics	When the package runs in verbose mode, the package shows the statistics about the package runtime and rows sent.
catalog.object_parameters	Shows a list of all the parameters by package and project.
catalog.projects	Lists all the projects installed in the SSIS catalog.
catalog.packages	Contains a list of all the packages in SSIS projects and folders.

STORED PROCEDURES

STORED PROCEDURE ALL IN THE CATALOG SCHEMA	USE
create_folder	Creates an SSIS folder in the catalog. create_folder [ @folder_name = ] folder_name, [ @folder_id = ] folder_id OUTPUT
create_environment	Create a new environment. create_environment [ @folder_name = ] folder_name , [ @environment_name = ] environment_name [ , [ @environment_description = ] environment_description ]
create_environment_reference	Maps an environment to a project. create_environment_reference [ @folder_name = ] folder_name , [ @project_name = ] project_name , [ @environment_name = ] environment_name , [ @reference_location = ] reference_location [ , [ @environment_folder_name = ] environment_folder_name ] [ , [ @reference_id = ] reference_id OUTPUT ]
create_execution	Instantiates a package before execution. create_execution [ @folder_name = folder_name , [ @project_name = ] project_name , [ @package_name = ] package_name [ , [ @reference_id = ] reference_id ] [ , [ @use32bitruntime = ] use32bitruntime ] , [ @execution_id = ] execution_id OUTPUT
start_execution	Starts the package execution and is run directly after create_execution. start_execution [ @execution_id = ] execution_id
set_execution_parameter_value	Sets parameters values for a given execution prior to the run of the package. Used after the create_execution stored procedure but before the start_execution stored procedure. set_execution_parameter_value [ @execution_id = execution_id , [ @object_type = ] object_type , [ @parameter_name = ] parameter_name , [ @parameter_value = ] parameter_value
stop_operation	Stops a package run with an operation_id. stop_operation [ @operation_id = ] operation_id