Aveek Das
SSIS Project executed

Getting started with SSISDB

July 13, 2020 by

In this article, I am going to explain how to start using the SSISDB database, also known as the SSIS Catalog database. In my previous article, I have provided an overview of this SSIS catalog database in detail. I would recommend you read that article, before moving on further with this if you want to understand how the SSIS catalog database works. The SSIS catalog database is one single database in which you can deploy all your SSIS packages and then organize and manage those packages centrally.

Creating the SSIS Package

To begin with, let us start by creating the SSIS package that we will be using to demonstrate how to use the SSISDB database. Head over to Visual Studio and start by creating a new Integration Services project. This will be a very simple package that has a Data Flow Task in it. We will simply read data from a source table in SQL Server and then write it back to a destination table in a different SQL Server database. For demonstrating the use of Environment variables, we will also have two databases for each DEV and PROD as follows.

  • SQLShackDemo_DEV
    • SourceTable
    • DestinationTable
  • SQLShackDemo_PROD
    • SourceTable
    • DestinationTable

You can run the following script to create these four tables and insert some dummy data into it.

Once you run the above script, you can see the following information being already available in the tables.

DEV and PROD tables

Figure 1 – DEV and PROD tables

Let us begin by adding the connection manager to the SSIS project. Right-click on the panel to create both the connection managers as follows.

Creating the OLEDB Connection Manager for Source

Figure 2 – Creating the OLEDB Connection Manager for Source

Click New to create a new connection manager.

Creating the new connection manager

Figure 3 – Creating the new connection manager

Specify the Server name and the database name and click on Test Connection. If the connection is successful, you can click OK and move forward. For now, we will go ahead by selecting the SQLShackDemo_DEV database.

Connecting to the DEV database

Figure 4 – Connecting to the DEV database

Once the connection manager is created successfully, you can see it on the Connection Managers pane below. Let us now go ahead and create the Data Flow Task.

Creating the Data Flow Task

Drag and drop a Data Flow Task to the Control Flow pane of the SSIS Window. Inside the Data Flow Task, add the following two objects.

  • OLEDB Source
  • OLEDB Destination

For OLEDB Source, we will select the SourceTable and for OLEDB Destination, we will select the DestinationTable.

Selecting the datasource for OLEDB Source

Figure 5 – Selecting the datasource for OLEDB Source

OLEDB Destination Editor

Figure 6 – OLEDB Destination Editor

Once both the objects are set up correctly, you can map the columns accordingly. Finally, you can see the following.

Data Flow Task Created

Figure 7 – Data Flow Task Created

Building and Executing the SSIS Package

Now that we are done with building our SSIS Package, let’s go ahead and build it. Select Build from the menu bar and click on Build Solution.

Build Solution

Figure 8 – Build Solution

As soon as you build your project, you can see the build window at the bottom. You can read the messages until it reads Build complete.

Build complete

Figure 9 – Build complete

Now that our SSIS package is built, we can go ahead and run this package. Hit F5 on your keyboard or click on Start on the menu bar. As the project executes, it will transfer all the records from your source table to the destination table.

SSIS Project executed

Figure 10 – SSIS Project executed

Deploying the ISPAC File to SSISDB

So far, we have created our SSIS package and executed it in debug mode. Now let us go ahead and try to deploy it. We can then execute the package from the SSISDB database directly. Whenever we build an SSIS project, the output of the build is an ISPAC file, also known as the Integration Services Package file. You can easily find this file by browsing the bin directory of the SSIS solution. If there is a DBA in your organization, you can hand over this ISPAC file to them and then can carry out the deployment in the production environment.

Browsing the ISPAC file

Figure 11 – Browsing the ISPAC file

Now, as mentioned in my previous article, there are multiple steps you can choose to deploy your ISPAC file as follows:

  • Using SQL Server Management Studio
  • Using the SQL Server Data Tools / Visual Studio
  • Using TSQL scripts

For the sake of this tutorial, we will go ahead with the SQL Server Management Studio (SSMS) option. Head over to SSMS and expand the SSISDB database. Right-click and select Create Folder. A folder is a logical group that you may consider which is available in the SSISDB database. You can organize your multiple SSIS projects in these folders. Usually, I try to create a folder for each of the customers I work with. Using this way helps me to isolate all the projects for a customer under one single folder in the SSISDB database. Give this folder some valid name and that’s it.

Creating a folder in SSISDB

Figure 12 – Creating a folder in SSISDB

You will be prompted to provide a name and a description for this new folder. Please proceed accordingly. Click on OK once done.

Creating the SQLShackDemoFolder

Figure 13 – Creating the SQLShackDemoFolder

You can see that this folder is now present under the SSISDB database. You are now good to deploy the SSIS project. Expand the folder name and there you can see the two objects – Projects and Environments. Right-click on the project and select Deploy Project to deploy our ISPAC file to the SSIS catalog database. This will open up the Integration Services Deployment Wizard where you can specify the location of the package.

Integration Services Deployment Wizard

Figure 14 – Integration Services Deployment Wizard

Click on Next to move forward. In the next window that appears, select the deployment model as Project Deployment and enter the path of the ISAPC file from the directory.

Project Deployment Model

Figure 15 – Project Deployment Model

On the next page, you need to provide the destination where the package is going to be deployed. Enter the Server Name with the correct authentication type and click Connect. You can see that the path of the folder is already available where the ISPAC file is going to be deployed.

Deploying the SSIS Project

Figure 16 – Deploying the SSIS Project

Click on Deploy once done. The wizard will take some time and deploy the project to the selected folder.

SSIS Project Deployed

Figure 17 – SSIS Project Deployed

Also, you can refresh the folder and see the project being deployed here successfully. Now let us go ahead and configure this package to execute with the production data. Right-click on the project name and select Configure.

Configure Project

Figure 18 – Configure Project

In the Configure window, select the tab for Connection Managers and update the InitialCatalog value as shown in the figure below and click OK.

Project Configured

Figure 19 – Configuring the project

Now if you execute the project, you can see the data is being populated into the SQLShackDemo_PROD database.

Destination Table

Figure 20 – Destination Table

Conclusion

In this article, I have explained how to start using the SSISDB on SQL Server. This database, also known as the SSIS catalog is the single database in the SQL Server instance which holds all the SSIS packages. With this catalog database, you can easily deploy all your SSIS packages in one central location and administer it easily. You can organize those packages in multiple folders and create projects under each of those folders. I have already talked about the structure of the SSIS catalog database in one of my previous articles. Please feel free to read it once in case you have any doubts understanding the structure and overview of the SSIS catalog database.

Aveek Das
Integration Services (SSIS)

About Aveek Das

Aveek is an experienced Data and Analytics Engineer, currently working in Dublin, Ireland. His main areas of technical interest include SQL Server, SSIS/ETL, SSAS, Python, Big Data tools like Apache Spark, Kafka, and cloud technologies such as AWS/Amazon and Azure. He is a prolific author, with over 100 articles published on various technical blogs, including his own blog, and a frequent contributor to different technical forums. In his leisure time, he enjoys amateur photography mostly street imagery and still life. Some glimpses of his work can be found on Instagram. You can also find him on LinkedIn View all posts by Aveek Das

6,256 Views