Stay organized with collections
Save and categorize content based on your preferences.
This page explains how to use Java Database Connectivity (JDBC) drivers with
Cloud Data Fusion pipelines.
Some plugins in Cloud Data Fusion require a JDBC driver to be added to the
namespace. For example, before you can run a pipeline with a MySQL batch source
plugin, you must add the supported MySQL driver to the namespace. You can add
JDBC drivers to a namespace from the Cloud Data Fusion Hub, the Namespace
admin page, or the Add entity page. You can also delete unneeded JDBC
drivers from the Namespace admin page.
Add a JDBC driver
Hub
To add a JDBC driver from the Cloud Data Fusion Hub, follow these steps:
In the Cloud Data Fusion Studio, click Hub>Drivers, and click a driver.
Optional: To get information about where to download the JAR file, click
Download.
Click Deploy, upload the JAR file, and click Next.
Verify the class name and version of the driver.
Click Finish.
Cloud Data Fusion adds the driver to the namespace.
Namespace admin page
To add a JDBC driver from the Namespace administrator page, follow these
steps:
Download a driver. For example, to download the JDBC driver for MySQL, go
to dev.mysql.com and download the JAR file.
In Cloud Data Fusion, click
menuMenu>Namespace Admin.
On the Namespace page, click Drivers.
Upload your JAR file and click Next.
Enter the name and class of the driver.
Click Finish.
The driver is added to the namespace.
Add entity page
To add a JDBC driver from the Add entity page, follow these steps:
Download a driver. For example, to download the JDBC driver for MySQL, go
to dev.mysql.com and download the JAR file.
On the Pipeline page, click the green plus sign.
On the Add entity page that appears, go to Driver and click
Upload.
Upload the JAR file and click Next.
Enter the name and class of the driver.
Click Finish.
The driver is added to the namespace.
Use a JDBC driver
On the Pipeline page in the Cloud Data Fusion Studio, choose a
plugin from the Source or Sink list. The node for the source or sink
appears in your pipeline.
Hold the pointer over the node in the pipeline and click Properties.
In the Reference name field, enter the name you defined for the driver in
the preceding Add a JDBC driver step.
Click closeClose.
Delete a JDBC driver
To delete a JDBC driver from a namespace, follow these steps:
In Cloud Data Fusion, click menuMenu>Namespace Admin.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-29 UTC."],[[["\u003cp\u003eThis page explains how to add, use, and delete Java Database Connectivity (JDBC) drivers within Cloud Data Fusion pipelines.\u003c/p\u003e\n"],["\u003cp\u003eJDBC drivers can be added to a namespace through the Cloud Data Fusion Hub, the Namespace admin page, or the Add entity page.\u003c/p\u003e\n"],["\u003cp\u003eTo use a JDBC driver, you must select a relevant source or sink plugin within the pipeline, and specify the driver's reference name in the plugin's properties.\u003c/p\u003e\n"],["\u003cp\u003eUnneeded JDBC drivers can be deleted from the namespace through the Namespace admin page.\u003c/p\u003e\n"]]],[],null,["# Plugin drivers\n\nThis page explains how to use Java Database Connectivity (JDBC) drivers with\nCloud Data Fusion pipelines.\n\nSome plugins in Cloud Data Fusion require a JDBC driver to be added to the\nnamespace. For example, before you can run a pipeline with a MySQL batch source\nplugin, you must add the supported MySQL driver to the namespace. You can add\nJDBC drivers to a namespace from the Cloud Data Fusion Hub, the **Namespace\nadmin** page, or the **Add entity** page. You can also delete unneeded JDBC\ndrivers from the **Namespace admin** page.\n\nAdd a JDBC driver\n-----------------\n\n### Hub\n\n\nTo add a JDBC driver from the Cloud Data Fusion Hub, follow these steps:\n\n1. In the Cloud Data Fusion Studio, click **Hub** \\\u003e **Drivers**, and click a driver.\n2. Optional: To get information about where to download the JAR file, click **Download**.\n3. Click **Deploy** , upload the JAR file, and click **Next**.\n4. Verify the class name and version of the driver.\n5. Click **Finish**.\n\nCloud Data Fusion adds the driver to the namespace.\n\n### Namespace admin page\n\n\nTo add a JDBC driver from the **Namespace administrator** page, follow these\nsteps:\n\n1. Download a driver. For example, to download the JDBC driver for MySQL, go to `dev.mysql.com` and download the JAR file.\n2. In Cloud Data Fusion, click menu **Menu** \\\u003e **Namespace Admin**.\n3. On the **Namespace** page, click **Drivers**.\n4. Upload your JAR file and click **Next**.\n5. Enter the name and class of the driver.\n6. Click **Finish**.\n\nThe driver is added to the namespace.\n\n### Add entity page\n\n\nTo add a JDBC driver from the **Add entity** page, follow these steps:\n\n1. Download a driver. For example, to download the JDBC driver for MySQL, go to `dev.mysql.com` and download the JAR file.\n2. On the **Pipeline** page, click the green plus sign.\n3. On the **Add entity** page that appears, go to **Driver** and click **Upload**.\n4. Upload the JAR file and click **Next**.\n5. Enter the name and class of the driver.\n6. Click **Finish**.\n\nThe driver is added to the namespace.\n\nUse a JDBC driver\n-----------------\n\n1. On the **Pipeline** page in the Cloud Data Fusion Studio, choose a plugin from the **Source** or **Sink** list. The node for the source or sink appears in your pipeline.\n2. Hold the pointer over the node in the pipeline and click **Properties**.\n3. In the **Reference name** field, enter the name you defined for the driver in the preceding [Add a JDBC driver](#upload-driver) step.\n4. Click close **Close**.\n\nDelete a JDBC driver\n--------------------\n\nTo delete a JDBC driver from a namespace, follow these steps:\n\n1. In Cloud Data Fusion, click menu **Menu** \\\u003e **Namespace Admin**.\n2. On the **Namespace** page, click **Drivers**.\n3. Choose a driver and click more_vert **More**.\n4. Click **Delete**.\n\nWhat's next\n-----------\n\n- Learn about [configuring plugins](/data-fusion/docs/concepts/plugins)."]]
