Guideline Setting Up a Microsoft SQL Server JDBC Connection within IBM Product(s): IBM Area of Interest: Infrastructure
2 Copyright and Trademarks Licensed Materials - Property of IBM. Copyright IBM Corp. 2009 IBM, the IBM logo, and Cognos are trademarks or registered trademarks of International Business Machines Corp., registered in many jurisdictions worldwide. Other product and service names might be trademarks of IBM or other companies. A current list of IBM trademarks is available on the Web at http://www.ibm.com/legal/copytrade.shtml While every attempt has been made to ensure that the information in this document is accurate and complete, some typographical errors or technical inaccuracies may exist. IBM does not accept responsibility for any kind of loss resulting from the use of information contained in this document. The information contained in this document is subject to change without notice. This document is maintained by the Best Practices, Product and Technology team. You can send comments, suggestions, and additions to cscogpp@ca.ibm.com. Microsoft, Windows, Windows NT, and the Windows logo are trademarks of Microsoft Corporation in the United States, other countries, or both.
3 Contents 1 INTRODUCTION... 4 1.1 PURPOSE...4 1.2 APPLICABILITY...4 2 IBM COGNOS VIRTUAL VIEW MANAGER AND THE MICROSOFT SQL SERVER JDBC CONNECTION... 4 2.1 OBTAINING THE MICROSOFT SQL SERVER JDBC DRIVER...4 2.2 INSTALLING THE MSSQL JDBC DRIVER...5 2.3 CREATING A MSSQL DATA SOURCE CONNECTION AND PERFORMING AN IMPORT...5
4 1 Introduction 1.1 Purpose This document outlines the steps required to setup a Microsoft SQL Server Java Database Connectivity (JDBC) connection within IBM Cognos Virtual View Manager. 1.2 Applicability The techniques and product behaviours outlined in this document apply to: IBM 8.4.27.23-0 2 IBM and the Microsoft SQL Server JDBC Connection IBM uses JDBC connectivity in order to be able to extract metadata and data from a Microsoft SQL Server (MSSQL) database. By default, IBM does not provide the JDBC connectors required to do this extraction. As a result, a user who attempts a MSSQL connection within IBM Virtual View Manager studio will be presented with the following error: 2.1 Obtaining the Microsoft SQL Server JDBC Driver IBM Virtual View Manager uses the sqljdbc.jar file in order to connect to MSSQL 2005. Alternatively it requires the msutil.jar, mssqlserver.jar and msbase.jar files to connect to MSSQL 2000. These drivers, along with others, are available from the Microsoft Site: http://www.microsoft.com/downloads/details.aspx?familyid=4f8f2f01-1ed7-4c4d- 8f7b-3d47969e66ae&displaylang=en
5 2.2 Installing the MSSQL JDBC Driver To install the MSSQL JDBC driver: 1. Stop the IBM 8.4.0 Service. 2. Copy the appropriate jar file(s) to the..\ vvm\apps\dlm\cis_ds_mssql\lib directory. 3. Start the IBM 8.4.0 Service. 2.3 Creating a MSSQL Data Source Connection and Performing an Import The following section will provide the steps required to connect and import data from a MSSQL 2005 database. 1. Within IBM Virtual View Manager Studio, create a new data source by right mouse clicking on the Sources folder and selecting New Data Source from the available menu items. 2. Within the New Physical Data Source dialog box, select Microsoft SQL Server 2005 from the available data sources list. 3. Click the Next button. 4. Fill out the appropriate connection details and click the Next button. The image below is an example of a completed connection dialog box.
6 5. Select the desired metadata from the gosales schema. For this example the gosales\product table is selected. 6. Click the Finish button to import the Gosales\Product metadata. Once the import completes, the metadata should be visible within the left hand resource tree.
7