Oracle

Hevo supports the following variations of Oracle as a Source:

Click each variant above to know the prerequisites and pre-configuration setups specific to it. Once you complete the setups, follow the steps mentioned below to configure it as a Source in your Hevo Pipeline and start ingesting data.


Select the Source Type

To select Oracle as the Source:

  1. Click PIPELINES in the Asset Palette.

  2. Click + CREATE in the Pipelines List View.

  3. In the Select Source Type page, select the Oracle variant.

Select the Pipeline Mode

Select how you want Hevo to read your data from the Oracle Source. This can be Redo Log, Custom SQL, or Table.

Read Pipeline Modes.

For Pipeline mode as RedoLog or Table, you can configure the objects to be replicated. See Objects and Query mode below.

Specify Oracle Connection Settings

Provide your Oracle database connection details in the Configure your Oracle Source page:

Oracle Settings

  • Pipeline Name: A unique name for your Pipeline.

  • Database Host: The Oracle database host’s IP address or DNS.

  • Database Port: The port on which your Oracle server is listening for connections. Default value: 3306.

  • Database User: The authenticated user that can read the tables in your database.

  • Database Password: Password for the database user.

  • Service Name: An alias of the unique Oracle database to which Hevo connects. To retrieve the Service Name, open your Oracle server in any SQL client tool as a database user with SYSDBA privilege and enter the following command:

    select name from v$database;
    
  • Schema Settings

    • Owner: The name of the schema owner to identify the schemas for ingesting the data. Data of all the schemas defined by the specified owner are ingested for replication. This is required if Pipeline mode is Table or Custom SQL.

    • Load All Schema: Select this toggle option to load data for all the schemas. This is applicable when Pipeline mode is Redo Log.

  • Connection Settings

    • Connect through SSH: Enable this option to connect to Hevo using an SSH tunnel, instead of directly connecting your Oracle database host to Hevo. This provides an additional level of security to your database by not exposing your Oracle setup to the public. Read Connecting Through SSH.

    If this option is disabled, you must whitelist Hevo’s IP addresses to allow Hevo to connect to your Oracle database host. Refer to the content for your Oracle variant for steps to do this.

  • Advanced Settings

    If Pipeline mode is RedoLog, specify:

    • Load Historical Data: If this option is enabled, the entire table data is fetched during the first run of the Pipeline. If disabled, Hevo loads only the data that was written in your database after the time of creation of the Pipeline.

    • Merge Tables: If this option is enabled, Hevo merges tables with the same name from different databases while loading the data to the warehouse. Hevo loads the Database Name field with each record. If disabled, the database name is prefixed to each table name. Read How does the Merge Tables feature work?.

Click TEST & CONTINUE.


Objects and Query Mode

Do one of the following:

  • For Pipeline with Table or RedoLogs mode:

    1. In the SELECT OBJECTS YOU WANT TO REPLICATE page, select the objects to be replicated and click CONTINUE.

      Note: Each object represents a table in your database.

    2. In the CONFIGURE SOURCE OBJECTS page, specify the query mode to be used for each selected object. This can be Delta Timestamp or Unique Incrementing Append Only.

  • For Pipeline with Custom SQL mode:

    1. In the Provide Query Settings page, enter the custom SQL query to fetch data from the Source.

    2. In the Query Mode drop-down, select the query mode.

Continue to complete the subsequent steps and configure the Destination system.

Last updated on 22 Feb 2021