How to deploy and execute an SSIS package from the SSISDB catalog
By Stan Kulp, 2016/05/24
In this walk-through we will create a simple SSIS package that writes to a database table, deploy the SSIS project containing the package to the SQL Server Integration Service's catalog and execute the package (1) from the SSIS Catalog's
Execute Package GUI and (2) from a T-SQL script generated by the
Execute Package
GUI.
1. Create a destination table
Create a table for our test package to populate by executing the following T-SQL code...
CREATE TABLE TestDB.dbo.Test ( [TimeStamp] [datetime] NULL ) ON [PRIMARY]
...in SQL Server Managment Studio.
![](http://www.sqlservercentral.com/Images/29065.jpg)
![](http://www.sqlservercentral.com/Resources/Images/zoom.gif)
2. Create an SSIS project
Create an SSIS project in Business Intelligence Development Studio named
SSIS Catalog Demo.
![](http://www.sqlservercentral.com/Images/29047.jpg)
![](http://www.sqlservercentral.com/Resources/Images/zoom.gif)
3. Modify the project's default SSIS package
A default SSIS package named Package.dtsx was created by the project.
![](http://www.sqlservercentral.com/Images/29052.jpg)
![](http://www.sqlservercentral.com/Resources/Images/zoom.gif)
Double-click the
Execute SQL Task node of the
SSIS Toolbox to add an
Execute SQL Task component to the default package.
![](http://www.sqlservercentral.com/Images/29053.jpg)
![](http://www.sqlservercentral.com/Resources/Images/zoom.gif)
Right-click in the
Connection Managers panel and select
New OLE DB Connection from the popup menu.
![](http://www.sqlservercentral.com/Images/29055.jpg)
![](http://www.sqlservercentral.com/Resources/Images/zoom.gif)
Click the
New button to create a new connection manager.
![](http://www.sqlservercentral.com/Images/29056.jpg)
Enter the relevant connection information and click the
OK button.
![](http://www.sqlservercentral.com/Images/29057.jpg)
Right-click the
Execute SQL Task component and select
Edit from the popup menu.
![](http://www.sqlservercentral.com/Images/29058.jpg)
![](http://www.sqlservercentral.com/Resources/Images/zoom.gif)
Click on the
Connection node of the
Execute SQL Editor panel and select the
TestServer connection manager.
![](http://www.sqlservercentral.com/Images/29059.jpg)
![](http://www.sqlservercentral.com/Resources/Images/zoom.gif)
Click on the SQLStatement node of the Execute SQL Task Editor...
![](http://www.sqlservercentral.com/Images/29061.jpg)
![](http://www.sqlservercentral.com/Resources/Images/zoom.gif)
...to bring up the
Enter SQL Query panel.
![](http://www.sqlservercentral.com/Images/29062.jpg)
Paste the following T-SQL code...
INSERT INTO TestDB.dbo.Test (TimeStamp) VALUES (GETDATE()) GO
...into the
Enter SQL Query
panel and click the OK button.
![](http://www.sqlservercentral.com/Images/29063.jpg)
Click the
OK button on the
Execute SQL Task Editor panel.
![](http://www.sqlservercentral.com/Images/29064.jpg)
![](http://www.sqlservercentral.com/Resources/Images/zoom.gif)
4. Execute the SSIS package from Development Studio
Click on the
Start Debugging green arrow button of the package editor.
![](http://www.sqlservercentral.com/Images/29066.jpg)
![](http://www.sqlservercentral.com/Resources/Images/zoom.gif)
The green check mark indicates that the package ran successfully and inserted a record into the TestDB.dbo.Test table.
![](http://www.sqlservercentral.com/Images/29068.jpg)
![](http://www.sqlservercentral.com/Resources/Images/zoom.gif)
5. Confirm that the package worked
Enter the following T-SQL code...
SELECT * FROM TestDB.dbo.Test
...into SQL Server Management Studio and execute it to confirm that a record was added to the table.
![](http://www.sqlservercentral.com/Images/29071.jpg)
![](http://www.sqlservercentral.com/Resources/Images/zoom.gif)
6. Create the SSISDB Integration Services catalog
Browse to the Integration Services Catalogs of SQL Server 2012 or above in Management Studio.
![](http://www.sqlservercentral.com/Images/29072.jpg)
![](http://www.sqlservercentral.com/Resources/Images/zoom.gif)
Right-click on the Integration Services node and select Create Catalog from the popup menu.
![](http://www.sqlservercentral.com/Images/29073.jpg)
![](http://www.sqlservercentral.com/Resources/Images/zoom.gif)
Populate the
Password and
Retype Password fields and click the OK button.
![](http://www.sqlservercentral.com/Images/29074.jpg)
![](http://www.sqlservercentral.com/Resources/Images/zoom.gif)
An empty folder named SSISDB has been created under the Integration Services Catalog folder.
![](http://www.sqlservercentral.com/Images/29075.jpg)
![](http://www.sqlservercentral.com/Resources/Images/zoom.gif)
Right-click on the SSISDB folder and select the Create Folder menu item.
![](http://www.sqlservercentral.com/Images/29076.jpg)
![](http://www.sqlservercentral.com/Resources/Images/zoom.gif)
Enter the folder name Test and click the OK button.
![](http://www.sqlservercentral.com/Images/29078.jpg)
![](http://www.sqlservercentral.com/Resources/Images/zoom.gif)
Empty folders named Projects and Environments have been created under the Test folder.
![](http://www.sqlservercentral.com/Images/29079.jpg)
![](http://www.sqlservercentral.com/Resources/Images/zoom.gif)
7. Deploy the SSIS project to the SSIS catalog
Right-click on the
SSIS Catalog Demo project name in Development Studio and select the
Deploy menu item.
![](http://www.sqlservercentral.com/Images/29080.jpg)
![](http://www.sqlservercentral.com/Resources/Images/zoom.gif)
Click on the
Next button in the
Integration Services Deployment Wizard panel.
![](http://www.sqlservercentral.com/Images/29081.jpg)
Enter the name of the server and the path to the catalog to be created and click
Next.
![](http://www.sqlservercentral.com/Images/29082.jpg)
Click the Deploy button.
![](http://www.sqlservercentral.com/Images/29083.jpg)
Click the Close button of the deployment wizard panel after obserivng the four green checkmarks that confirm the deployment was successful.
![](http://www.sqlservercentral.com/Images/29084.jpg)
Right-click the SSISDB folder and select the Refresh menu item.
![](http://www.sqlservercentral.com/Images/29097.jpg)
![](http://www.sqlservercentral.com/Resources/Images/zoom.gif)
Expand the folders under the Test folder to confirm that the package has been deployed to the server.
![](http://www.sqlservercentral.com/Images/29098.jpg)
![](http://www.sqlservercentral.com/Resources/Images/zoom.gif)
8. Execute the SSIS package from the catalog with the Execute Package GUI.
Right-click on the package and select
Execute from the popup menu.
![](http://www.sqlservercentral.com/Images/29099.jpg)
![](http://www.sqlservercentral.com/Resources/Images/zoom.gif)
Click the
OK button on the
Execute Package GUI panel.
![](http://www.sqlservercentral.com/Images/29089.jpg)
![](http://www.sqlservercentral.com/Resources/Images/zoom.gif)
Click the
Yes button on the dialog box that asks if you wish to open the overview report.
![](http://www.sqlservercentral.com/Images/29090.jpg)
A report opens in SQL Server Management Studio that indicates our package was successfully executed.
![](http://www.sqlservercentral.com/Images/29100.jpg)
![](http://www.sqlservercentral.com/Resources/Images/zoom.gif)
Execute the previous SELECT query again to confrim that another record has been added to the table by the SSIS package.
![](http://www.sqlservercentral.com/Images/29101.jpg)
![](http://www.sqlservercentral.com/Resources/Images/zoom.gif)
9. Create the SSIS catalog execution script from the Execute Package GUI
Right-click the package and select
Execute once again.
![](http://www.sqlservercentral.com/Images/29102.jpg)
![](http://www.sqlservercentral.com/Resources/Images/zoom.gif)
This time select
New Query Editor Window from the
Script menu at the top of the
Execute Package panel, then click the
OK button.
![](http://www.sqlservercentral.com/Images/29093.jpg)
![](http://www.sqlservercentral.com/Resources/Images/zoom.gif)
Click the No button on the dialog box to prevent a report from being created.
![](http://www.sqlservercentral.com/Images/29090.jpg)
Observe that a new query editor window containg SQL code has been opened in SQL Server Management Studio
![](http://www.sqlservercentral.com/Images/29103.jpg)
![](http://www.sqlservercentral.com/Resources/Images/zoom.gif)
10. Run the script
Execute the script to run the SSIS package from the catalog.
![](http://www.sqlservercentral.com/Images/29104.jpg)
![](http://www.sqlservercentral.com/Resources/Images/zoom.gif)
Execute the SELECT query again to confirm that the package inserted another record into the table.
![](http://www.sqlservercentral.com/Images/29105.jpg)
![](http://www.sqlservercentral.com/Resources/Images/zoom.gif)
Conclusion
In this article we demonstrated how to deploy an SSIS package to the SSIS catalog and how to execute the package directly from the Execute Package GUI and from a SQL Script generated by the Execute Package GUI.