Uploading Data

Once signed in, the ibi Data Quality UI offers different navigational views to get you started.

To upload data, click Explore New Data in the upper-right corner of the Home Page, as shown in the following image.

The Explore New Data dialog opens, as shown in the following image.

You can upload data from a text file or JDBC data source (PostgreSQL, SQL Server, etc.).

Click either File Upload or JDBC datasource.

Uploading Data From a Text File

To upload data from a text file (for example, .csv):

  1. Drag an input text file to the upload window or browse to the local file system and select an input text file. File upload supports text files up to max 5GB.

    Note: Your input data set cannot have a column name “dq_recid”. This column name is reserved for the system to automatically assign unique row identifiers for each row in the input data set.

  2. Click Next.

    The Add Context pane opens, as shown in the following image.

  3. Add business context for your input data.

    Tip: Setting up the right business context helps users filter DQ statistics and metrics in the ibi Data Quality Watchdog App.

    Property

    Description

    Save As

    Data set name if different from file name.

    Source Name

    Name of the data source.

    Source Type

    Is the data source considered internal or external to the organization.

    Application Name

    Name of the application that generated the input data.

    Industry

    Select an industry represented by the data.

    Entity

    Name of the business entity the data represents (e.g., customer, partner, supplier, office).

  4. Provide parsing options for your input data.

    Property

    Description

    File character set

    Character encoding, supported types are UTF-8, UTF-16, or ISO-8859-1.

    File has header

    True if file has a header column, False otherwise.

    File Delimiter

    Field delimiter, supported delimiters are Comma (,), Pipe(|), Semicolon (;), Space, or Tab.

    Quote Character

    Define the enclosing character if text within a field includes the delimiter character. Supported characters are double quote (“) or grave accent (`).

Uploading Data From a JDBC Data Source

This section describes how to upload data from a JDBC data source.

New JDBC Connection

To upload data from a JDBC data source using a new JDBC connection:

  1. Provide the SQL select statement to read data from a table or a view.

  2. Provide the source database user name and password.
  3. Select a JDBC driver from the list of available drivers.
  4. Provide the hostname, port, and database name.
  5. Provide any optional JDBC connection parameters as required.
  6. Toggle Save Connection if you intend to save and reuse this JDBC connection.

  7. Click Next to continue with the rest of the data upload steps.

Existing JDBC Connection

To upload data from a JDBC data source using an existing JDBC connection:

  1. If you want to reuse an existing JDBC connection, click Saved Connections and select from the list of available JDBC connection strings.

  2. Provide the SQL select statement to read data from a table or a view.
  3. Click Next to continue with the rest of the data upload steps.

Sample JDBC Connection Strings

The following provides sample JDBC connection strings for reference purposes.

Database: SQL Server
Format

jdbc:sqlserver://[serverName[\instanceName][:portNumber]]

Example

jdbc:sqlserver://localhost:1433;databaseName=AdventureWorks

Database: Postgre SQL

Format

jdbc:postgresql://host:port/database

Example

jdbc:postgresql://localhost:5432/AdventureWorks

Database: Oracle

Format

jdbc:oracle:thin:@host:port:database

Example

jdbc:oracle:thin:@localhost:1521:AdventureWorks

Database: MySQL

Format

jdbc:mysql://localhost:port/database

Example

jdbc:mysql://localhost:3306/AdventureWorks

Caution: Code snippets in the PDF could have undesired line breaks due to space constraints and should be verified before directly copying and running them in your program.

Tracking Upload Progress

The upload progress bar displays the current upload status, as shown in the following image.