Updated on 2022-12-08 GMT+08:00

Managing Drivers

The Java Database Connectivity (JDBC) provides programmatic access to relational databases. Applications can execute SQL statements and retrieve data using the JDBC API.

Before connecting CDM to a relational database, you need to upload the JDK 8 .jar driver of the relational database.

Prerequisites

  • A cluster has been created.
  • You have downloaded one of the drivers listed in Table 1.
  • (Optional) An SFTP link has been created by referring to Link to an FTP or SFTP Server and the corresponding driver has been uploaded to the offline file server.

How Do I Obtain a Driver?

Select a driver version that adapts to the database type. Note that the version of the uploaded driver does not need to match the version of the database to be connected. Obtain the JDK8 .jar driver of the recommended version by referring to Table 1.

Table 1 Drivers

Relational Database Type

Driver Name

How to Obtain

Recommended Version

  • RDS for MySQL
  • MySQL

MySQL

MyCAT

https://downloads.mysql.com/archives/c-j/

mysql-connector-java-5.1.48.jar

Oracle

ORACLE_6

ORACLE_7

ORACLE_8

Driver packages: https://www.oracle.com/database/technologies/appdev/jdbc-downloads.html

Driver packages of historical versions: https://repo1.maven.org/maven2/com/oracle/database/jdbc/ojdbc8/12.2.0.1/

ojdbc8.jar for version 12.2.0.1

NOTE:

New versions (for example, Oracle Database 21c (21.3) drivers) are not supported. If they are used, the schema name cannot be obtained during job creation.

  • RDS for PostgreSQL
  • PostgreSQL

POSTGRESQL

https://jdbc.postgresql.org/download

postgresql-42.1.4.jar for JDBC 4.2

  • RDS for SQL Server
  • Microsoft SQL Server

SQLServer

Driver packages:

https://docs.microsoft.com/en-us/sql/connect/jdbc/download-microsoft-jdbc-driver-for-sql-server?view=sql-server-ver15

Driver packages of historical versions:

https://docs.microsoft.com/en-us/sql/connect/jdbc/release-notes-for-the-jdbc-driver?view=sql-server-ver15#previous-releases

sqljdbc42.jar

Procedure

  1. Access the CDM console, choose Cluster Management in the navigation pane, locate the target cluster, and choose Job Management > Link Management > Driver Management. The Driver Management page is displayed.

    Figure 1 Uploading a driver

  2. Click Upload in the Operation column and select a local driver.

    Alternatively, click Copy from SFTP in the Operation column and configure the SFTP Link name and Driver File Path.

  3. (Optional) If you have uploaded an updated version of a driver, you must restart the CDM cluster for the new driver to take effect.