5 Connecting to Microsoft Data Sources Through ODBC Connection

Case Study

This case study shows you how to use an Excel file called employees.xls as a source in Oracle Warehouse Builder.

Step 1: Install ODBC Driver for Excel

To read data from Microsoft Excel, you need the ODBC driver for Excel. By default, the ODBC driver for Excel is installed on a Windows system.

Step 2: Delimit the Data in the Excel File (Optional)

If you want to delimit the data to be imported from the Excel file, then define a name for the range of data being sourced:

1. In the employee_details worksheet, highlight the range to query from Oracle.

   The range should include the column names and the data. Ensure that the column names confirm to the rules for naming columns in the Oracle Database.

2. From the Insert menu, select Name and then Define. The Define Name dialog box is displayed. Specify a name for the range.

Step 3: Create a System DSN

Set up a System Data Source Name (DSN) using the Microsoft ODBC Administrator.

1. Select Start, Settings, Control Panel, Administrative Tools, Data Sources (ODBC).

   This opens the ODBC Data Source Administrator dialog box.

2. Navigate to the System DSN tab and click Add to open the Create New Data Source dialog box.

3. Select Microsoft Excel Driver as the driver for which you want to set up the data source.

   Click Finish to open the ODBC Microsoft Excel Setup dialog box.

   The ODBC Microsoft Setup dialog box is shown in Figure 5-1.

   Figure 5-1 ODBC Microsoft Excel Setup Dialog Box

   
   Description of "Figure 5-1 ODBC Microsoft Excel Setup Dialog Box"
   
   

4. Specify a name for the data source. For example, odbc_excel.

5. Click Select Workbook to select the Excel file from which you want to extract data.

6. Verify that the Version field lists the correct version of the source Excel file.

Step 4: Create the Heterogeneous Services Initialization File

To configure the agent, you must set the initialization parameters in the heterogeneous services initialization file. Each agent has its own heterogeneous services initialization file. The name of the Heterogeneous Services initialization file is initSID.ora, where SID is the Oracle system identifier used for the agent. This file is located in the OWB_HOME\hs\admin directory.

Create the initexcelsid.ora file in the OWB_HOME\hs\admin directory as follows:

HS_FDS_CONNECT_INFO = odbc_excel
HS_AUTOREGISTER = TRUE
HS_DB_NAME = dg4odbc

Here, odbc_excel is the name of the system DSN you created in Step 3. excelsid is the name of the Oracle system identifier used for the agent.

Step 5: Modify the listener.ora file

Set up the listener on the agent to listen for incoming requests from the Oracle Database. When a request is received, the agent spawns a Heterogeneous Services agent. To set up the listener, modify the entries in the listener.ora file located in the OWB_HOME\network\admin directory as follows:

SID_LIST_LISTENER =
  (SID_LIST =
    (SID_DESC =
      (SID_NAME = excelsid)
      (OWB_HOME = C:\oracle11g\product\11.2.0\db_1)
      (PROGRAM = dg4odbc)
    )
    (SID_DESC =
      (SID_NAME = PLSExtProc)
      (OWB_HOME = C:\oracle11g\product\11.2.0\db_1)
      (PROGRAM = extproc)
      )
  )

1. For the SID_NAME parameter, use the SID that you specified when creating the initialization parameter file for the Heterogeneous Services, which, in this case, is excelsid..

2. Ensure that the OWB_HOME parameter value is the path to your Oracle Database home directory.

3. The value associated with the PROGRAM keyword defines the name of the agent executable.

Remember to restart the listener after making these modifications.

Step 6: Create an ODBC Source Module

Use the following steps to create an ODBC source module:

1. From the Projects Navigator, create an ODBC source module.

   ODBC is listed under the Databases node. See "Creating an ODBC Module".

2. To provide connection information, on the Connection Information page, click Edit to open the Edit Non-Oracle Location dialog box and provide the following details:

   Ensure that the service name you provide equals the SID_NAME you specified in the listener.ora file.

   Enter the host name and the port number in the Host and Port fields respectively.

   Because you are not connecting to an Oracle database, you can provide dummy values for user name and password. The fields cannot be empty.

   The Schema field can be left empty because you are not importing metadata from a schema.

   Click Test Connection to verify the connection details.

Step 7: Import Metadata from Excel Using the Metadata Import Wizard

Use the Metadata Import Wizard to import metadata from the Excel file into Oracle Warehouse Builder. Select Tables as the Filter condition. The wizard displays all the worksheets in the source Excel file under the Tables node in the list of available objects.

1. Select employee_details and use the right arrow to move it to the list of selected objects.

2. Click Finish to import the metadata.

   The data from the employee_details worksheet is now stored in a table called employee_details in the ODBC source module.

Step 8: Create a Mapping to Load Data Into the Target Table

Create a mapping in the module that contains the target table. Use the employee_details table imported in the previous step as the source and map it to the target table.

Figure 5-2 displays the mapping used to load data into the target table.

Figure 5-2 Mapping to Load Data Into the Target Table

Description of "Figure 5-2 Mapping to Load Data Into the Target Table"

Step 9: Deploy the Mapping

Use the Control Center Manager or Design Center to deploy the mapping you created in step 8. Ensure that you first deploy the source module before you deploy the mapping. See Oracle Warehouse Builder Data Modeling, ETL, and Data Quality Guide for more information about mappings.

Troubleshooting

This section lists some errors that you may encounter while providing the connection information.

Error

ORA-28546: connection initialization failed, porbable Net8 admin error

ORA-28511: lost RPC connection to heterogeneous remote agent using
SID=(DESCRIPTION=(ADDRESS_LIST=(ADDRESS=(PROTOCOL=TCP)(Host=localhost)(PORT=1521)))(CONNECT_DATA=(SID=oracledb)))

ORA-02063: preceeding 2 lines from OWB###

Probable Cause

Providing the same SID name as that of your database.

Action

Provide an SID name different from the SID name of your database.

Error

ORA-28500: connection from ORACLE to a non-Oracle system returned this message: 
[Generic Connectivity Using ODBC][H006] The init parameter <HS_FDS_CONNECT_INFO> 
is not set. Please set it in init<orasid>.ora file.

Probable Cause

Name mismatch between SID name provided in the listener.ora file and the name of the initSID.ora file in OWB_HOME\hs\admin.

Action

Ensure that the name of the initSID.ora file and the value provided for the SID_NAME parameter in listener.ora file is the same.

Creating an ODBC Data Source

You must create an ODBC data source to connect to the SQL Server database using ODBC. You must set up a System Data Source Name (DSN):

1. Select Start, Control Panel, Administrative Tools, Data Sources (ODBC).

   This opens the ODBC Data Source Administrator dialog box.

2. Navigate to the System DSN tab and click Add to open the Create New Data Source dialog box.

3. Select SQL Server as the driver for which you want to set up the data source.

4. Click Finish to open the Create A New Data Source to SQL Server Wizard.

5. In the Name field, specify a name for the data source. For example, sqlsource.

6. In the Server field, select the server to which you want to connect and click Next.

7. Specify whether the authentication should be done at the Operating System level or at the server level. Click Next.

8. Select the database file and click Next.

9. Accept the default values in the next screen and click Finish.

10. Test the data source to verify the connection.

Configuring the Oracle Database Server

Next, you must configure the Oracle database to connect to the SQL Server database. Oracle Warehouse Builder can then use this configuration to extract metadata from the SQL Server database. This involves the following steps:

• "Creating a Heterogeneous Service Configuration File"

• "Editing the listener.ora file"

HS_FDS_CONNECT_INFO = sqlsource
HS_FDS_TRACE_LEVEL = 0

SID_LIST_LISTENER =
  (SID_LIST =
    (SID_DESC =
      (SID_NAME = sqlserver)
      (OWB_HOME = c:\oracle10g\owb_home)
      (PROGRAM = dg4odbc)
    )
    (SID_DESC =
      (SID_NAME = PLSExtProc)
      (OWB_HOME = c:\oracle10g\owb_home)
      (PROGRAM = extproc)
      )
  )

Adding the SQL Server as a Source in Oracle Warehouse Builder

The final step involves adding an ODBC module in Oracle Warehouse Builder, and importing the data from the SQL server into this module.

To add an ODBC source module in Oracle Warehouse Builder:

1. Within a project in the Projects Navigator, navigate to the Databases node.

2. Right-click ODBC and select New ODBC Module.

3. Create a new ODBC module using the Create Module Wizard.

4. Use the Connection Information page to provide the location details. To create a new location, click Edit to open the Edit Non-Oracle Location dialog box.

5. In the Edit Location dialog box, ensure that you enter user name and password within double quotation marks ("). For example, if the user name is matt, then enter "matt".

6. For Service Name, enter the SID name you provided in the listener.ora file. Also select the schema from which you want to import the metadata.

7. Click Test Connection to verify the connection details.

To import metadata into the ODBC module:

1. Right-click the module and select Import.

2. Import the metadata using the Import Metadata Wizard.

   The tables and views available for import depend on the schema you selected when providing the connection information.

Troubleshooting

Some of the errors that you may encounter while providing the connection information are listed here:

Error

ORA-28500: connection from ORACLE to a non-Oracle system returned this message: 
[Generic Connectivity Using ODBC][Microsoft][ODBC Driver Manager] Data source name 
not found and no default driver specified (SQL State: IM002; SQL Code: 0)

ORA-02063: preceding 2 lines from OWB_###

Probable Cause

Creating the DSN from the User DSN tab.

Action

Create the DSN from the System DSN tab.

Error

ORA-28500: connection from ORACLE to a non-Oracle system returned this message: 
[Generic Connectivity Using ODBC][Microsoft][ODBC SQL Server Driver][SQL 
Server]Login failed for user 'SA'. (SQL State: 28000; SQL Code: 18456)

ORA-02063: preceding 2 lines from OWB_###

Probable Cause

The user name and password in the Edit Location dialog box are not enclosed within double quotation marks.

Action

Enter the user name and password within double quotation marks.