Import Table Wizard

From DataSelf Knowledge Base
Revision as of 06:08, 7 April 2014 by Cwilson (talk | contribs) (Next button)
Jump to navigation Jump to search

Import Table Wizard - Start window

Import Table Wizard - Start window

The Import Table Wizard - Start wizard shows all the data sources that are currently configured and available in the ETL.


A data source is a named collection of metadata that describes how to connect to source data. See data connection for more information.
The names of data sources already defined are listed in the Data Source column.

Data Source Type (Type column)

The data source types are:

Can be used to connect to SQL Server, other ODBC compliant databases, Excel files, Access databases and other source data. But note that the data source types listed below use technologies that are usually more efficient and are the recommended way to connect to those types of source data.

Buttons & Fields

Data Source column

Displays the names assigned to Data Sources.

Click on a row to select it for further action.

See also the discussion above on the data source types displayed in the [[#Data Source Type (Type column)|Type column}}.

Driver column
Type column

See the discussion above.

Add button

The Add button opens the Import Table Wizard - Data Source Settings window which allows the creation of new data sources.

Edit button

Edits the selected Data Source.

Delete button

Deletes the selected Data Source.

Next button

Configures a new imported table using the selected Data Source.

Import Table Wizard - Data Source Settings window

Data Source type options of Import Table Wizard - Data Source Settings window.

Navigation to here: From Import Table Wizard - Start click Add.
There are three versions of this wizard depending on the Data Source type. The options are: MS SQL SERVER, MS Excel, and MS Access.

Data Source type = "MS SQL SERVER"

ImportTableWizard DSS MSSLQSereverOption.png
Server Name field.

In the Server Name field enter the instance name of SQL Server. The instance name is the same name as used to login using Microsoft SQL Server Management Services.

SQL Server Instance Names
  • “local” should be written as “(local)”, “localhost” or the name of the machine.
  • If an name/instance requires the “Instance Name>” then it would be “(local)instance name>”.

NOTE: The instance name of an SQL Server is informally known as the server name.
SQL Server Setup sets the instance name to the computer name during installation.


To find an SQL Server’s Instance Name:
  1. open SQL Server Configuration Manager (search for it in the Start menu).
  2. Click on SQL Server Services.
    The instance name of SQL Server is in parenthesis inline with SQL Server service. If it says MSSQLSERVER, then it’s the default instance.
  3. To connect to it in Management Studio, just type . (dot) OR (local) and click Connect.
    If the instance name is different, then use .instance name] to connect to it (for example if the instance name is SQL2008, connect to .2008).

Also make sure SQL Server and SQL Server Browser services are running, otherwise you won’t be able to connect.

Data Source type = “MS Excel”

MS Access option of Import Table Wizard - Data Source Settings window

In versions of the ETL prior to version 2013.002.xx access to Excel files required an ODBC connection. While the older ODBC connections still work the Import Table Wizard - Data Source Settings window configures a connection using a technology called an Excel provider.

Finish button

Clicking the Finish button attempts to configure a data connection to the specified Excel file on the host computer.


  • For Excel files the data connector (the software which runs on the host computer) is also known as an Excel provider.

Excel version pull-down list box

The Microsoft Excel 2007 option is compatible with all versions of Excel files (e.g. .xls, xlsx, xlsm)

Data Source type = “MS Access”

MS Access option of Import Table Wizard - Data Source Settings window

Import Table Wizard - Select Tables window

Navigation to here: From Import Table Wizard - Start click Next.

Import Table Wizard - Select Tables window.

Advanced button

Import Table Wizard - Table ... - Select Fields window

Navigation to here: From Import Table Wizard - Select Tables click Next.

Import Table Wizard - Table ... - Optional: Select Data Grouping window

Navigation to here: From Import Table Wizard - Select Fields click Next.

"var char" message

NOTE: The MediaWiki software does not allow us to show "var char" as a single word.

Import Table Wizard - Finish window

Table Union option selected.

Import Table Wizard ... - Table Union window

Imports and combines data from the AR_Customer tables from the DSDW_Sage100 and DSMAS90200 data sources respectively.

Alternative version of this section

Union Concepts

An ETL Table Union will merge two or more source tables into a single table in the data warehouse. Here are some examples of application of this feature:

  • When combining archived and current data (ex.: invoices) so people can analyze all historical data from a single imported table.
  • When consolidating multi-company systems into a single data warehouse. For instance, the invoices from 3 source ERPs will merge into a single imported invoice table. Users will be able to easily analyze invoices from all 3 ERPs from a single imported table, and then use filters to slice it.

The ETL Table Union is based upon the SQL's UNION operator. In SQL the UNION operator combines the result of two or more SELECT statements.

Target Structure

The fields selected in the Import Table Wizard#Import Table Wizard - Table ... - Select Fields window define the field names and data types of the data that will be combined in the table imported by the union operation; call this the target structure (better name?).

The source tables must have the same column names and data types as the target structure.

For instance:

  • Source table 1 columns: CustName (char 50), CustNo (char 10), CreditStatus (int)
  • Source table 2 columns: CustName (char 50), CustNo (char 10), City (char 50)
  • target structure: CustName (char 50), CustNo (char 10), TableID.

NOTE: The source tables may have columns not listed in the target structure. Those columns will not be imported and otherwise will be ignored by the union operation.

Table Union Configuration

The top white panel shows the current Table Union configuration. To change the parameters configuration:

  • Click "Add Table" button to add a line and configure its parameters in the boxes below the white panel.
  • Select a line in the white panel and enter/adjust the values in the boxes below the white panel.
  • To remove a line, select it and click the "Remove" button.
  • To change the 1st line: you'll have to get out of the Table Union wizard. Use Import Table Wizard#Import Table Wizard - Table ... - Select Fields window.

Here's an explanation of the parameters:

TableId column

The ETL Table Union adds a column named TableID that can be used to indicate the source of the data in each row. On the example pictured above, the table union is combining records from the AR_Customer table from DSDW_SAGE100 and DSMAS90200 data sources. In the target table, records from DSDW_SAGE100 will be flagged with TableID 001 and the other with 002.

Sage 300 and Sage 500 already have internal columns to handle multi-company setups. So you do NOT have to populate TableID when unioning tables from these systems.

Table Name

Name of the source tables to be unioned.

Data Filter

Filter applied during the data import for each table unioned.

Data Source Name

Data source from where the table will be imported from.

Test table and field structure check box

When checked the ETL validates if columns mapped from the source tables match the target structure.

NOTE: This process can be time consuming when working with large source tables, so you may consider disabling when you are sure the source data structures match.