Oracle Data Connection

  • Last update: September 19, 2024
  • Overview

    Application Scenario

    FineDataLink supports connection to the Oracle database for data reading/writing using scheduled tasks and pipeline tasks and for releasing data services.

    Preparation 

    Version and Driver 

    Supported Database VersionDriver Package Download

    Oracle 11.1

    Oracle 11.2/11g-R2 

    Oracle 12.1/12c-R1 

    Oracle 12.2/12c-R2

    Oracle 13 and above

    (Built-in) No need to download.

    Oracle 9.2.0/9i

    Oracle 10.1

    Oracle 10.2/10g-R2

    ojdbc14.jar

    For the specific steps of uploading the driver package, see Driver Management.

    Oracle 19c and above

    The latest driver package is recommended. For details on downloading the driver package, see Driver Downloading. Select the ojdbc.jar file of the specified version.

    Note: Close the project before uploading the driver package, replace the original ojdbc8.jar file in % FineDataLink %/webapps/webroot/WEB-INF/lib with the new one, and then restart the project.

    Connection Information Collection 

    Collect the following information before connecting FineDataLink to the database.

    • IP address and port number of the database server

    • Database name

    • Username and password of the database

    • Database pattern

    Procedure 


    Thin Mode

    If you need to use this data connection for data development tasks, data service tasks, and LogMiner-based data pipelines, follow the steps below.

    Log in to FineDataLink, choose System Management > Data Connection > Data Connection Management, and click New Data Connection.

    Note: If you are not the admin, you can configure data connections only after the admin assigns you permission on Data Connection under Permission Management > System Management. For details, see Data Connection Management Permission.

    Click the Oracle database.

    Fill in the connection information. To use a built-in driver, select Default. To use the driver you upload, click Custom and select the required driver.

    You cannot set Pattern unless the database is connected. Click Click to Connect Database and then click Pattern, as shown in the following figure.

    Note: The Oracle database is case-sensitive, so pay attention to the letter case when filling in the database name and the pattern. 

    The following table describes the driver, database name, and URL.

      Driver Database NameURL


    oracle.jdbc.driver.

    OracleDriver 

    sid_name 

    jdbc:oracle:thin:@IP address:Port number:sid_name

    service_name

    jdbc:oracle:thin:@//IP address:Port number/service_name 

    or

    jdbc:oracle:thin:@IP address:Port number/service_name 

    TNSName

    Note: The tnsnames.ora file is required in the Oracle installation directory.

    jdbc:oracle:thin:@TNSName

    The value of sid_name can be queried using the statement: Select INSTANCE_NAME from v$instance.

    TNSName is described as follows.

    In the URL (jdbc:oracle:thin:@TNSName), the value of TNSName is the value of ORCL in the tnsnames.ora file, as shown in the following figure.

    The full URL is as follows:

    jdbc:oracle:thin:@
    (DESCRIPTION=(ADDRESS_LIST=
    (ADDRESS=(PROTOCOL=Protocol)(HOST=IP address)(PORT=Port number)))
    (CONNECT_DATA=
    (SERVER=DEDICATED)
    (SERVICE_NAME=Service Name)))

    OCl Mode

    The Thin driver is not available if you need to use this data connection to synchronize data from a container database (CBD) through XStream using pipeline tasks as the connection to XStream relies on the OCI driver.

    Modify the data connection URL above to the following one.

    jdbc:oracle:oci:@(DESCRIPTION=
    (ADDRESS=(PROTOCOL=Protocol)(HOST=IP address)(PORT=Port number))
    (CONNECT_DATA=(SID=Database Name)))

    The value of HOST is the IP address of the Oracle server, the value of PORT is the port number, and the value of SID is the database name.

    Data Source Usage

    After configuring the data source, you can use it in Data Development. For details, see Overview of Data Development.

    After configuring the data source, you can use it in Data Pipeline. For details, see Overview of Data Pipeline.

    After configuring the data source, you can use it in Data Service. For details, see Overview of Data Service.

    If you need to use the data source for setting pipeline tasks with data from pluggable databases (PDB), modify the database of this connection to the corresponding PDB database.

     

    附件列表


    主题: Data Source Configuration
    • Helpful
    • Not helpful
    • Only read

    滑鼠選中內容,快速回饋問題

    滑鼠選中存在疑惑的內容,即可快速回饋問題,我們將會跟進處理。

    不再提示

    10s後關閉

    Get
    Help
    Online Support
    Professional technical support is provided to quickly help you solve problems.
    Online support is available from 9:00-12:00 and 13:30-17:30 on weekdays.
    Page Feedback
    You can provide suggestions and feedback for the current web page.
    Pre-Sales Consultation
    Business Consultation
    Business: international@fanruan.com
    Support: support@fanruan.com
    Page Feedback
    *Problem Type
    Cannot be empty
    Problem Description
    0/1000
    Cannot be empty

    Submitted successfully

    Network busy