In Part 2 we look at creating our data source SSIS base package.  Click here to review Part 1.

Editor’s Note: This article is excerpted from chapter 5 of Extract, Transform, and Load with SQL Server Integration Services--with Microsoft SQL Server, Oracle, and IBM DB2, by Thomas Snyder and Vedish Shah.

Finally! We have installed all our software and set up our databases. Now we can start creating our SSIS packages. We will be completing this chapter by creating a new SSIS package that will contain our data sources and could be reused as the starting point for any new SSIS packages. We will walk through the creation to support the project overview; however, now is a great opportunity for you to custom-tailor your data sources so they fit your intended environment setup.

To begin creating our SSIS packages, follow these steps:

• 1. Open Visual
• 2. Select File > New Project….
• 3. Select Templates > Business Intelligence > Integration Services Project.
• 4. Enter the name for your project, then select the directory location to be created (Figure 5.9).

Figure 5.9: Selecting the Integration Services Project as the SSIS project

Once you click OK, your empty SSIS package will be created, and you can now add our connection managers, which will connect to your databases.

DB2 Connection Manager

To create our DB2 database connection manager, go to the bottom panel labeled Connection Managers, right-click it, and select New OLE DB Connection…, as shown in Figure 5.10.

Figure 5.10: Creating a new connection for the DB2 source connection

When we installed the OLE DB drivers using the iSeries Access installation, we reviewed the different types of OLE DB drivers that were installed:

• IBMDA400—SQL and record-level access (RLA) support
• IBMDASQL—SQL-only support
• IBMDARLA— RLA-only support

To keep the topics as applicable to as many databases as possible, we will be using the SQL-only driver IBMDASQL. The RLA features will not be used here.

When you select the New OLE DB Connection… option for the first time, the screen in Figure 5.11, Configure OLE DB Connection Manager, will be blank. You’ll need to click the New… button at the bottom of the screen to specify your database information.

Figure 5.11: Creating a new connection for the DB2 source connection

From the provider drop-down, you can see the IBM DB2 OLE DB providers that are available. Please select the IBMDASQL driver.

Set up your connection manager using the settings in Table 5.1, making changes for your machine, if necessary.

After selecting IBMDASQL OLE DB Provider, you will need to enter the server name and user information. Another useful setting is the default collection, which will likely be the top entry in your library list in IBM lingo, or the catalog in Microsoft land. To set the default collection, click the Data Links… button (Figure 5.12) to assign any additional attributes such as the Default Collection.

Figure 5.12: Connection Manager and Data Link properties with connection test

When you're specifying your database details, it's a good idea to click the Test Connection button to ensure that your information has been entered correctly and that your authentication method is working. This will help you avoid having to troubleshoot your SSIS package when/if you have a connection problem.

SQL Server Database Connection Manager

To create our database source connection manager, right-click in the Connection Manager panel again, and select New OLE DB Connection…. After selecting the New OLE DB Connection… option, we will need to configure it. To do so, click the New... button, which will open the Connection Manager screen (Figure 5.13).

Figure 5.13: Providing login information for the SQL Server connection

Set up your connection manager using the settings shown in Table 5.2, making changes for your machine, if necessary.

Oracle Database Connection Manager

And if you haven’t guessed, for our final connection manager we will be going to the Connection Manager screen to add our final Oracle database connection, by selecting New OLE DB Connection… (Figure 5.14).

Figure 5.14: Providing login information for the Oracle database XX5

You will notice there are two Oracle options: Microsoft OLE DB Provider for Oracle and Oracle Provider for OLE DB. The Microsoft driver already existed prior to the installation and will not work. We will use the Oracle driver that was installed with ODAC.

Click Test Connection to ensure that you have entered everything correctly; you should get a confirmation of success. When you click OK to save, you will receive the following error, shown in Figure 5.15:

The given path's format is not supported.

To resolve this error, simply delete the colon before the port number on the server, which will look like this: localhost1521/XE (notice the colon was removed). Then save it.

Figure 5.15: Bypassing a common Oracle obstacle by saving the port number without a colon

Then return to the properties and update the server to add the colon back in. This is currently a known problem documented on MSDN.

You could also remove the port number altogether, and then the connection will use the default port, but I always like to define the extreme cases to support every scenario—as you may have surmised based on our current endeavor to make SSIS talk to every database known to man.

Base Project

To complete our base project, let’s shed the database qualifications from our data sources by homogenizing them to generically reference our database connections. When you click on each of the connection managers, you can change the name in the properties window that is displayed in the bottom right corner of the visible window. Go through each of your connection managers and rename them ORD, SOR, and DWH, accordingly, as shown in Figure 5.16.

Figure 5.16: Homogenizing connection manager names

Now that we have added all the data sources for our project, you should save your base project and tuck it safely away for future use. At the beginning of each of the following chapters, we will be copying the base project as our starting point for each new project. This free us from the details of setting up our connections and working through any connection details.

Now is the perfect time for you to customize your project to use the databases that you’re interested in. At this point, you could create your base project to have three databases in SQL Server, if you wanted to, and they should work fine for the projects ahead. You could also revisit Appendix A for details about MySQL or PostgreSQL, so you can use one of those databases in your base project. Simply rename your database connections to ORD, SOR, and DWH, and everything else should look the same. The only exceptions will come in database-specific syntax nuances that we’ll try to point out when applicable.

SSIS is really about the implementation of design patterns in a literal sense for SQL software development. This is much like how high-level languages (HLLs) such as Java and C# use object-oriented concepts with the literal usage of objects and inheritance.

Look for TechTip: Data Source Base Project, Part 3: SSIS Code Structure from Tom's book in an upcoming issue of MC TNT. Can't wait?  Pick up your copy of Tom's book, Extract, Transform, and Load with SQL Server Integration Services at the MC Press Bookstore Today!

Thomas Snyder has a diverse spectrum of programming experience encompassing IBM technologies, open source, Apple, and Microsoft and using these technologies with applications on the server, on the web, or on mobile devices.

Tom has more than 20 years' experience as a software developer in various environments, primarily in RPG, Java, C#, and PHP. He holds certifications in Java from Sun and PHP from Zend. Prior to software development, Tom worked as a hardware engineer at Intel. He is a proud United States Naval Veteran Submariner who served aboard the USS Whale SSN638 submarine.

Tom is the bestselling author of Advanced, Integrated RPG, which covers the latest programming techniques for RPG ILE and Java to use open-source technologies. His latest book, co-written with Vedish Shah, is Extract, Transform, and Load with SQL Server Integration Services.

Originally from and currently residing in Scranton, Pennsylvania, Tom is currently involved in a mobile application startup company, JoltRabbit LLC.

---

MC Press books written by Thomas Snyder available now on the MC Press Bookstore.

		Advanced, Integrated RPG See how to take advantage of the latest technologies from within existing RPG applications. List Price $79.95 Now On Sale
		Extract, Transform, and Load with SQL Server Integration Services Learn how to implement Microsoft’s SQL Server Integration Services for business applications. List Price $79.95 Now On Sale