This tutorial shows how to set up a data source and connect to a MySQL® database using the Database Explorer app or the command line. This tutorial uses the MySQL Connector/J 5.1.46 driver to connect to a MySQL Version 5.5.16 database.
If the JDBC driver for MySQL is not installed on your computer, find the link on the Driver Installation page to install the driver. Follow the instructions to download and install this driver on your computer.
prefdir function in the Command Window. The output of this command is a file path to the MATLAB® preferences folder on your computer. For details, see
Navigate to the folder from step 1, and create a file named
javaclasspath.txt in the folder.
javaclasspath.txt. Add the full path to the
database driver JAR file in
javaclasspath.txt. The full
path includes the path to the folder where you downloaded the JAR file from
the database provider followed by the JAR file name. The following is an
example of the path:
Save and close
This step is required only for connecting to a database using the Database Explorer app. If you want to use the command line to connect to your database, see Connect to MySQL Using JDBC Driver and Command Line.
Open the Database Explorer app by clicking the Apps tab on the MATLAB Toolstrip. Then, on the right of the Apps section, click the Show more arrow to open the apps gallery. Under Database Connectivity and Reporting, click Database Explorer. Alternatively, enter
databaseExplorer at the command line.
Select Configure Data Source > Configure JDBC data source.
The JDBC Data Source Configuration dialog box opens.
In the Name box, enter the name of your data source.
(This example uses a data source named
MySQL.) You use
this name to establish a connection to your database. If you enter a name
that duplicates an existing ODBC data source name, the Database Explorer app
_JDBC to the name after you save it.
From the Vendor list, select
MYSQL. If you did
not add the JDBC driver file path to the Java class path, the dialog box displays this message at the
Unable to find JDBC driver file on MATLAB Java class
path. Address this message by following the steps described in
In the Database box, enter the name of your database. In the Server box, enter the name of your database server. Consult your database administrator for the name of your database server. In the Port Number box, enter the port number.
Click Test. The Test Connection dialog box opens. Enter the user name and password for your database, or leave these boxes blank if your database does not require them. Click Test.
If your connection succeeds, the Database Explorer dialog box displays a message indicating the connection is successful. Otherwise, it displays an error message.
Click Save. The JDBC Data Source Configuration dialog box displays a message indicating the data source is saved successfully. Close this dialog box.
After you complete the data source setup, connect to the MySQL database using the Database Explorer app or the command line with the JDBC connection.
On the Database Explorer tab, in the Data Source section, click New Query.
In the Connect to a Data Source dialog box, select the data source you defined from the Data Source list. Enter a user name and password, or leave these boxes blank if your database does not require them. Click Connect.
The Catalog and Schema dialog box opens.
In the Catalog list, select the catalog. Click OK.
The Database Explorer app connects to the database and displays database tables in the Data Browser pane. A data source tab appears to the right of the pane. The title of the data source tab is the data source name that you defined during the setup. The data source tab contains empty SQL Query and Data Preview panes.
Select tables in the Data Browser pane to query the database.
Close the data source tab to close the SQL query and the database connection.
To close the database connection, close all tabs that have titles
beginning with the name of the corresponding data source. For
example, if the data source name is
two tabs named
MySQL1 are open, then close both tabs.
To close all database connections, close the Database Explorer app.
When using the command line, you do not have to set up a data source with the Database Explorer app. You can use the command line to pass all the required parameters for connection.
Vendor name-value pair argument of the
database function to specify a connection to a
MySQL database. For example, this code assumes that you are
connecting to a database named
dbname, on a database
sname, with the user name
username and the password
conn = database('dbname','username','pwd', ... 'Vendor','MySQL', ... 'Server','sname');
Close the database connection.