Stay organized with collectionsSave 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, theNamespace
adminpage, or theAdd entitypage. You can also delete unneeded JDBC
drivers from theNamespace adminpage.
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, clickHub>Drivers, and click a driver.
Optional: To get information about where to download the JAR file, clickDownload.
ClickDeploy, upload the JAR file, and clickNext.
Verify the class name and version of the driver.
ClickFinish.
Cloud Data Fusion adds the driver to the namespace.
Namespace admin page
To add a JDBC driver from theNamespace administratorpage, follow these
steps:
Download a driver. For example, to download the JDBC driver for MySQL, go
todev.mysql.comand download the JAR file.
In Cloud Data Fusion, clickmenuMenu>Namespace Admin.
On theNamespacepage, clickDrivers.
Upload your JAR file and clickNext.
Enter the name and class of the driver.
ClickFinish.
The driver is added to the namespace.
Add entity page
To add a JDBC driver from theAdd entitypage, follow these steps:
Download a driver. For example, to download the JDBC driver for MySQL, go
todev.mysql.comand download the JAR file.
On thePipelinepage, click the green plus sign.
On theAdd entitypage that appears, go toDriverand clickUpload.
Upload the JAR file and clickNext.
Enter the name and class of the driver.
ClickFinish.
The driver is added to the namespace.
Use a JDBC driver
On thePipelinepage in the Cloud Data Fusion Studio, choose a
plugin from theSourceorSinklist. The node for the source or sink
appears in your pipeline.
Hold the pointer over the node in the pipeline and clickProperties.
In theReference namefield, enter the name you defined for the driver in
the precedingAdd a JDBC driverstep.
ClickcloseClose.
Delete a JDBC driver
To delete a JDBC driver from a namespace, follow these steps:
In Cloud Data Fusion, clickmenuMenu>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-09-04 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)."]]
